Skip to main content
An organization holds your boxes, your members, and your settings. You can belong to more than one organization. Each organization keeps its own boxes, members, variables, and single sign-on configuration.

​
Switch organizations

The organization switcher is at the top of the sidebar. Select it, then select an organization in the Organizations list. The dashboard remembers your choice in this browser. If you do not belong to an organization, the switcher shows No organizations. To join an organization, ask one of its owners or admins for an invitation link. See Get an account.

​
Settings

To open the settings, select your avatar in the top bar, then select Settings. The settings open on the Account page. The settings navigation has two groups. A member sees only the Personal group. An admin does not see General and SSO in the Organization group. Owners and admins have the same permissions in the settings, except for these actions. Only an owner can do them:
  • Change the name, the slug, or the default box username of the organization.
  • Delete the organization.
  • Configure SSO.
  • Invite an owner, give the Owner role, or change the role of an owner.
For the full list of permissions, see Roles and permissions. These pages give more detail:

​
General

The General page shows the Organization Settings heading and three cards. Only owners see this page in the settings navigation, and only an owner can save changes on it.

​
Name and slug

The General card holds the Name and the Slug of the organization. To change them, edit the values, then select Save changes. The slug identifies the organization in URLs and in single sign-on. A slug can have up to 128 characters. It can contain lowercase letters, digits, and hyphens, and each hyphen must have a letter or a digit on both sides. No two organizations can have the same slug. Before you change the slug, tell your team. A new slug breaks the links that use the old slug, and people who sign in with SSO must type the new slug. When you save a new slug, the Change organization slug? dialog asks you to confirm. Select Save changes in the dialog.

​
Default box username

The Default Box Username card sets the SSH username that Stout gives to each new box that you add or import. Each box keeps its own username, and you can change the username of a box in its settings. To change the default username:
  1. Enter a name of up to 64 characters in Username.
  2. Select Save.
  3. In the Change default box username? dialog, select Save username.
Boxes that you added before the change keep their current username.

​
Delete the organization

Before you delete an organization, make sure that nobody needs its boxes, members, or settings. Deletion removes the organization and all of its data, and you cannot undo it.
Only an owner can delete the organization:
  1. In the Danger Zone card, select Delete organization.
  2. Type the slug of the organization.
  3. Select Delete permanently.

​
Standalone installs

Some organizations run Stout on their own server instead of on app.stoutdata.ai. On a standalone install, use the addresses of your install wherever these docs show app.stoutdata.ai or api.stoutdata.ai. A standalone install is different in these ways:
  • When a newer version of Stout is available, owners and admins see a notice above the page content. Select the notice to read the release notes and the update steps.
  • To update, a person with access to your Stout server runs ./update.sh in the install directory. Nothing updates until someone runs that command.
  • If your install does not send email, Forgot password? cannot send a reset link. An owner or admin must create the link on the Team Permissions page.
  • The footer can show Licensed to and the name of the license holder.
On app.stoutdata.ai, the update notice does not appear.