Sovrain
  1. Documentation
  2. Get started

How-to guide

Set up Sovrain for your company

The steps from creating your organization to one your whole company uses, in a sensible order, each with the guide that covers it.

This guide takes you from no organization to one your whole company can use. Each step links to the guide that covers it; skip the ones you do not need.

Create the organization

Three choices on the registration form stay with the organization, so make them before you start:

  • Organization name, for example Acme. It is shown on your organization’s home page and delegation pages, and next to the codes in authenticator apps. Sovrain has no setting to change it later. The name in the header, on sign-in pages and in emails can be changed later under Branding; see Brand your organization’s pages.
  • Organization URL, for example acme, which makes the address https://acme.sovrain.net. It cannot be changed later, but you can add your own domain on top of it. See Organizations and their addresses.
  • Data region: the server that stores the organization’s data. It cannot be moved later. See Regions and availability.

Then:

  1. Open sovrain.net/register and fill in the form with these choices.
  2. In Your email, enter your work email. Sovrain marks it optional, but as the only admin you need a verified email to reset your own password.
  3. Select Create organization, then Go to sign in, and sign in with your login name and password.

The tutorial Create your organization shows each screen of this.

Secure your own access first

  1. Verify your email address, so that you can reset your password: Verify your email address.
  2. Add a second step to your account: Set up an authenticator app, or Add a security key or passkey.
  3. Make a second person an owner or admin, so that someone can let you back in if you lose access: Make someone an admin. What each role can do is in Roles.

Decide your address before you connect apps

If you want people to sign in at your own domain, such as login.acme.example, set it up now: Use your own domain. Activating a domain later changes the address every connected app trusts, so each app would need to be updated.

Set the rules

  1. Decide who needs a second step: Require two-step sign-in.
  2. Decide how people recover a forgotten password or a lost second step: Set up account recovery.
  3. If you want, show your company’s name and colours: Brand your organization’s pages.

Bring your people in

  1. Create groups for the teams that use different apps, for example Engineering: Manage groups.
  2. Invite everyone, with a pasted list or a CSV file: Invite people. Send them Accept your invitation and open your apps.
  3. When someone cannot get in on their own, see Help someone back in.

Connect your apps

  1. For each app, follow Connect an OpenID Connect app or Connect a SAML app, whichever the app supports.
  2. Give the right groups access: Give a group access to an app.
  3. If an app can receive accounts over SCIM, let Sovrain create them: Provision accounts with SCIM.

Keep a copy

Download an encrypted backup of the organization now, and again after big changes: Back up your organization. If you ever need it, an owner loads it back with Restore or move your organization.