Skip to main content
You sign in to Terminus Hub with your email and a password, or through your company’s identity provider if your account uses single sign-on (SSO). If you have turned on two-factor authentication, you also enter a code from your authenticator app. This page covers every step of getting in, from creating an account to recovering from a lockout.
Connecting software to the REST API uses an API key, not a sign-in. See API keys to create one and API authentication for the request header.

Create an account

1

Fill in the sign-up form

Click Sign up on the sign-in screen and enter your Full Name, Email, Password (at least 10 characters), and Company Name. The company name is filled in from your email domain; change it if it is wrong. It becomes the account name your teammates see when you invite them. If a human verification check appears above the button, complete it; Sign Up stays disabled until you do. Click Sign Up. If you arrived from Sign up to use this template in the template gallery, the form names that template, and the welcome screen you see after you first sign in offers it.
2

Confirm your email

Terminus sends a confirmation link to your address. Click it to activate your account, then sign in. You cannot sign in until your email is confirmed. If the email does not arrive, use Resend confirmation email on the check-your-email screen.
Your new account starts on a Business trial and comes with a workspace named Main, so you can go straight to the quickstart. See Billing for what happens when the trial ends.

Sign in

Signing in is a two-step, email-first flow:
1

Enter your email

Type your email and click Continue. Terminus checks whether your email’s domain has single sign-on set up.
2

Enter your password, or continue with SSO

If your domain does not use SSO, the password field appears. Type your password and click Sign In. If your domain uses SSO, Terminus sends you to your identity provider to sign in there instead.
If you belong to more than one account, you pick which one to work in after signing in. If you belong to exactly one, Terminus opens it for you.

Single sign-on

When your email domain has SSO set up, Continue always sends you to your identity provider. Account owners and admins can still sign in with a password even when the account enforces SSO, so they have a way in if the identity provider is down. To do that, click Use a password instead on the sign-in screen before you click Continue. For a member at a domain that enforces SSO, the password route still ends at the identity provider. SSO is set up by an account admin and requires the Enterprise plan. See Single sign-on.

Two-factor authentication

If you have turned on two-factor authentication, signing in with your password takes you to a Two-factor authentication screen:
  1. Open your authenticator app and enter the 6-digit code it shows for Terminus Hub.
  2. Click Verify.
You have 10 minutes after entering your password to enter the code. After that, Terminus returns you to the sign-in screen with a message that your sign-in session expired, and you start again. If you sign in through SSO, your identity provider handles any second factor and Terminus Hub does not ask for a code. To turn two-factor authentication on or off for yourself, see Profile.

Use a backup code

When you set up two-factor authentication you saved 10 backup codes. If you do not have your authenticator app, click Use a backup code on the code screen and enter one of them (they look like 3f2a6-37d2d). Each backup code works once. Click Use your authenticator app to switch back.

If you lose your authenticator and your backup codes

Ask an owner or admin of your account to reset your two-factor authentication. The reset signs you out everywhere and emails you. You then sign in with only your password, and if the account requires two-factor authentication you set it up again before you can continue. See Team members for how admins reset a member. Admins cannot reset the account owner’s two-factor authentication, so if you are the owner, keep your backup codes somewhere safe.

When your account requires two-factor authentication

An account admin can require two-factor authentication for everyone in the account (see Security). If you have not set it up yet, signing in takes you to a setup screen instead of the app: confirm your password, scan the QR code with your authenticator app, enter the code it shows, then save your backup codes and tick I saved these codes. From that screen you can also Switch account or Sign out. Members who signed in through the account’s SSO are not asked to set it up.

Accept an invitation

When a teammate invites you, you get an email with a link. The link opens a page titled Account <name> invites you to join, which also shows the role you are being given.
  • If you are new to Terminus Hub, enter your Full Name and a Password (your email is already filled in from the invitation) and click Sign Up and Accept. You do not need to confirm your email separately; the invitation link already proves it.
  • If you already have a Terminus Hub login, click Sign in first, sign in, and you return to the invitation. Then click Proceed as <your name>.
An invitation link can stop working. The page tells you why:

If you cannot sign in

For security, a wrong password, an unknown email, and a locked account all show the same message. Check for typos, see the locked-account answer below, or click Forgot password? on the password step and then Send reset link to get a reset email. Reset links expire after 6 hours.
After 5 failed attempts your account locks for 15 minutes. Wrong two-factor codes count toward the same limit as wrong passwords. Wait 15 minutes, or use the unlock link Terminus emails you.
You cannot sign in until your email is confirmed. Signing in shows a banner with a resend option, or use Resend confirmation email on the check-your-email screen to get a fresh link.
Your domain has single sign-on set up. Click Use a password instead before Continue to get the password field. Owners and admins can always sign in with a password.
You took longer than 10 minutes to enter your two-factor code. Sign in again with your password and enter a fresh code.

Quickstart

Sign up and run the full Terminus Hub flow.

Profile

Change your password and turn on two-factor authentication.

Security

Require two-factor authentication for your whole account.

API keys

Authenticate software against the REST API.