Getting in

Everything in Swarm Release Manager lives behind a sign-in, so this is the very first screen you'll meet. This guide walks through every way you might get into the app — a normal sign-in, creating a new account, entering a two-factor code, recovering a forgotten password, verifying your email, and approving a tool that wants to connect. It also explains the one screen that can surprise a brand-new account: landing on No workspace yet.

You don't need to read this end to end. Jump to the section that matches where you are.

#Signing in

From the landing page, choose Log in. Enter the email address and password for your account and select Log in.

A few things worth knowing on this screen:

Remember me — tick this on a device that's yours and you'll stay signed in between visits instead of having to log in each time. Leave it off on shared or public computers.
Forgot your password? — this link sits next to the password field. If you can't remember your password, jump to resetting it.
Sign up — if you don't have an account yet, the link at the bottom takes you to registration.

If you've set up a passkey (a fingerprint, face, or device PIN saved to your phone or laptop), you'll see an option to sign in with it at the top of the screen — no password typing required. Choose it and confirm with your device the same way you unlock it.

If your email and password don't match an account, the app tells you right on the form and nothing else happens — just correct the entry and try again.

#Creating an account

Choose Sign up (or Register from the landing page) and fill in:

Name — how you'll appear to teammates.
Email address — where account and release notifications go.
Password and Confirm password — type the same password twice. The form enforces a minimum strength; if your password is too weak or the two entries don't match, it'll tell you before the account is created.

Select Create account to finish. Depending on how your app is set up you may be asked to verify your email before you can go further.

One thing to expect right after signing up: a new account isn't automatically part of a workspace. If you registered on your own rather than from an invitation, you'll likely land on the No workspace yet screen — that's normal, and the section below explains what to do.

#Entering a two-factor code

If two-factor authentication is turned on for your account, signing in takes one extra step. After your password is accepted, you'll be asked for a code.

Authentication code — open the authenticator app you set up (for example Google Authenticator, 1Password, or Authy), find the six-digit code for Swarm Release Manager, and type it in. The code rotates every few seconds, so if it's about to expire, wait for the next one. Select Continue.
Lost your phone? Choose login using a recovery code below the button. Enter one of the one-time recovery codes you saved when you turned on two-factor authentication. Each recovery code works once. You can switch back to the normal code entry with login using an authentication code.

If a code is rejected, the field clears so you can re-enter it cleanly. If you've run out of recovery codes and can't reach your authenticator, contact a workspace owner or your administrator to help you regain access.

#Resetting a forgotten password

Can't remember your password? On the sign-in screen choose Forgot your password?

Enter your email address and select Email password reset link. If that email belongs to an account, a reset link is on its way — the screen confirms it was sent. For your security the confirmation looks the same whether or not the email was recognised, so nobody can use this form to find out who has an account.

Open the email and follow the link. It brings you to a screen where your email is already filled in; just choose a new password, confirm it, and select Reset password.

A couple of notes:

The reset link is time-limited. If it's expired by the time you open it, simply request a fresh one from Forgot your password? again.
Once the reset succeeds you can sign in with the new password right away.

#Verifying your email

Some accounts need a verified email address before you can use the app. If yours does, you'll see a screen asking you to check your inbox for a verification link.

Open the email we sent when you registered and click the link inside — that's all it takes. If the email never arrived (check spam first), choose Resend verification email and we'll send a fresh one. There's also a Log out link here if you need to step away or switch accounts.

#Confirming your password again

Now and then, for a sensitive action — like changing security settings — the app asks you to confirm your password even though you're already signed in. This is a quick safety check that it's really you.

Enter your password (or confirm with your passkey, if you have one) and continue. You won't be asked again for a short while.

#Approving a connected tool

Swarm Release Manager can be driven by external tools and assistants through a secure connection. When you connect one for the first time, it sends you here to approve the request.

The screen names the tool asking to connect and shows exactly what it will be able to do on your behalf. Because everything in the app is scoped to a workspace, you also choose which workspace the tool may operate in — it only gets access to that one.

Pick the workspace from the list, then select Authorize to grant access.
Not expecting this, or changed your mind? Choose Cancel and nothing is granted.

If you see a note that you're not a member of any workspace yet, there's nothing to authorize — you'll need to be added to a workspace first, then start the connection again.

#Landing on "No workspace yet"

Workspaces are where your releases live, and every account needs to belong to at least one. If you sign in and see No workspace yet, it simply means your account isn't part of a workspace — most commonly because you just created the account on your own.

Here's how to move forward:

Waiting on an invitation? Ask a workspace owner to invite you. Invitations go to your account's email address — accept it and your releases appear the next time you land here.
Already have an invitation email? Open it and follow the link to accept. Once you do, this screen is replaced by your dashboard.

You don't need to do anything special on this screen itself; it clears on its own as soon as you're a member of a workspace.

#Signed in — what's next

Once you're through, you'll land on your dashboard. From there, the read-through guide walks you through the app from first sign-in to watching a release deploy. Start with Getting started to get your bearings.