Sign in and register

What this means

Two ways to start using Bilbis:

Register - create a brand-new account and an organization at the same time.
Sign in - return to an account you already have.

Both pages live at the front of the app, before you reach the dashboard.

When to use it

Your team doesn't have a Bilbis organization yet - register.
You have an account but you've been signed out - sign in.
A teammate invited you - see Invitations instead.

Register

Where to find it

Click Sign up on the marketing site, or go directly to /register.

Field reference

Field	What it means
Your name	Your display name. Used on team mentions and audit log entries.
Email	Sign-in email. Becomes the username on the account. Must be unique.
Password	At least 12 characters.
Confirm password	Must match.
Workspace name	Display name for your team's organization, like "Acme Inc." Shown in the UI as "Workspace name".
Workspace URL	Short slug used in the URL (`bilbis/<slug>/...`). Auto-derived from the organization name until you edit it. Shown in the UI as "Workspace URL".

If a Google or GitLab login is configured, you'll also see Continue with Google or Continue with GitLab buttons. Clicking one starts a single sign-on flow on the provider and brings you back signed in.

What happens after you submit

The form posts to Bilbis.
Bilbis sends a verification email to the address you supplied.
The page switches to a "Check your email" message with the address shown back.
Click the link in the email. See Email verification.
After verification, you land on the welcome wizard or your dashboard.

Trial

A new organization starts on a 7-day trial. No credit card up front.

Where to find it

/login - link is Sign in on the marketing site, or in the page header on the docs site.

Field reference

Field	What it means
Email	The email address you registered with.
Password	Your password.

If a single sign-on provider is configured, the Continue with Google or Continue with GitLab buttons appear here too. They sign you in instantly if your account is already linked to that provider.

What happens after you submit

There are three possible outcomes, decided by the server:

Outcome	What happens
Success	You land on your active organization's dashboard, or on the workspace picker if you belong to several.
MFA required	You're routed to the two-factor challenge page. See Multi-factor authentication.
MFA enrollment required	You're routed to enroll a second factor. Required for owner, admin, and platform-admin roles.

A few errors you might see:

Message	What it means
"Invalid email or password."	The credentials don't match an account.
"Please verify your email first. Check your inbox for the link."	The account exists but you haven't clicked the verification link yet.
"This account isn't active yet."	An admin has deactivated this account, or it's pending activation.
"Too many attempts. Try again in a few minutes."	Rate limit. Wait, then retry.

Forgot password

Click Forgot password? on the sign-in form. See Password reset.

Single sign-on (Google, GitLab)

Bilbis supports SSO when your operator has it configured. The buttons only appear if SSO is available.

A few things to know:

SSO is sign-in only. It does not bypass MFA when MFA is required.
A single sign-on flow can fail if the provider returns an error. The page shows "Sign-in failed: …" with the provider's reason.
SSO does not auto-create an organization. You still need to register first or accept an invite.

Permissions

Action	Who can do it
Register a brand-new account and organization	Anyone with a valid email.
Sign in	Anyone with valid credentials for an existing, active account.
Use SSO	Anyone whose account is linked to a configured SSO provider.

Problems and fixes

Problem	What to check
The email I want to register with is taken.	The address already has a Bilbis account. Sign in instead, or use a different email.
The workspace URL is taken.	Pick a different slug. Organization URLs are unique per Bilbis instance.
The verification email never arrived.	Check spam. Wait a minute. Use the resend flow on the verification page. See Email verification.
MFA is asking for a code I don't have.	If you have recovery codes saved, click Use a recovery code on the challenge page. Otherwise contact your admin.
SSO error after clicking Continue with Google.	The provider rejected the request. Try email + password instead, or contact your admin.
"Too many attempts" error.	Rate limit. Wait a few minutes. Don't click submit repeatedly.

Email verification - confirm your email after registering.
Password reset - recover a forgotten password.
Multi-factor authentication - second factor on sign-in.
Invitations - accept an invite from a teammate.
Quickstart - what to do once you're signed in.

On this page