Skip to main content
This page takes you from a new account to an instrument that you control from your browser.

​
Before you start

You need these three things:
  1. A Stout account in an organization. See Get an account.
  2. The Owner or Admin role. A member cannot add a box or control an instrument.
  3. A Lager Box that Stout can reach over the network. You need its IP address and the user name that you use for SSH on the box.
If you do not have a Lager Box yet, set one up with the Lager guide first.

​
1. Sign in

Go to app.stoutdata.ai and sign in. The Home page shows a card for each part of Stout that you can use.

​
2. Add the box

  1. In the sidebar, select Boxes. Then select Add Box.
  2. Enter the Box Name, the IP Address, and the Username.
  3. Select Add Box.
  4. In the Password Required window, enter the password of the box account.
  5. Select Install Stout.
  6. Wait for the install to finish. Then wait for the Securing this box… window to close.
A new box does not have the Stout key or passwordless sudo yet. The password gives Stout the access that it needs to secure the box. Stout uses the password for this install only, and it does not store the password. For the full procedure, see Add a box.

​
3. Add nets

A net is a name for one channel of an instrument on the box.
  1. Go to the Nets tab of the box page. The box page opens on this tab.
  2. Select Add Nets. Stout proposes one net for each free channel of the connected instruments.
  3. Check the proposed names. Then add the nets.
For more about nets, see Nets and templates.

​
4. Lock the box

A lock tells other people that you use the box. You must have a display name before you can lock a box.
  1. If you have no display name, go to Settings > Account and set one.
  2. In the sidebar, select Boxes.
  3. In the row for your box, select the open lock in the Lock column. The column then shows You.
For more about locks, see Locks.

​
5. Control an instrument

  1. In the sidebar, select Workbench.
  2. In the Box list, select your box. The list shows only boxes that are online and have an IP address.
  3. Select Control Instruments.
  4. Expand an instrument.
  5. Use the panel for a net to read or change the state of the instrument.
Before you change an instrument, make sure that you hold the lock on the box. If another person holds the lock, Stout refuses the change. This rule applies to owners and admins too.
For every panel and option, see Workbench.

​
Next steps

Add people

Invite people to your organization and assign boxes to them.

Run a Factory suite

Run scripted pass and fail tests for production and QA.

Store variables and secrets

Give your tests the settings and credentials that they need.

Set up single sign-on

Let your team sign in through your OIDC identity provider.