Skip to content
Docs
flero.ai

Signing up and logging in

This page covers getting into Flero for the first time. If your team admin has already created an account for you, jump to Logging in. If you have an invite link in your email, jump to Accepting a workspace invite.

Creating a new account

  1. Navigate to your Flero URL (typically https://app.flero.ai or your self-hosted address) and click Sign up under the login form, or visit /register directly.

    📸 Screenshot needed: signup__register-form.png, the register page with name, email, password, and confirm-password fields visible.

  2. Fill in:

    • Full name, appears on your profile and in audit logs.
    • Email, must be unique; will be used for notifications and password resets.
    • Password, 8+ characters, mixed case, at least one number. Strength indicator updates as you type.
    • Confirm password, must match.

  3. Click Create account.

Approval-pending accounts

If your Flero instance requires admin approval for new sign-ups (common in enterprise deployments), you'll see an Approval pending dialog rather than being logged in immediately. An administrator will get an email with a link to approve you; you'll get an email once they do. You can close the dialog in the meantime.

📸 Screenshot needed: signup__approval-pending-dialog.png, the "Your account is pending approval" dialog with the admin contact line.

Self-service approval

If approval is not required (single-user instance, public SaaS plan, or your email domain is on the auto-approve list), you'll be logged in straight away and dropped at the first-run onboarding flow.

Logging in

  1. Visit /login.
  2. Enter your email and password.
  3. Click Log in.

📸 Screenshot needed: login__form.png, the login screen with email/password fields and the "Forgot password?" link visible.

If you have MFA enabled

After password entry, you'll see the MFA prompt:

  • TOTP, open your authenticator app (1Password, Authy, Google Authenticator) and enter the 6-digit code.
  • SMS, enter the code that was just texted to your registered number.

Codes are valid for 30 seconds; if you mistype, just wait for the next one.

📸 Screenshot needed: login__mfa-prompt.png, the MFA verification dialog with a 6-digit code field and "Verify" button.

First-login MFA setup

If your workspace's security policy mandates MFA but you haven't enrolled yet, you'll be sent to /mfa-setup-required/:token after your first successful login. You can't reach the rest of the app until you finish enrolment. See Security & MFA.

Forgot password

  1. On /login, click Forgot password?
  2. Enter your email and click Send reset link.
  3. Check your inbox, the email arrives within a minute. The link expires after 24 hours.
  4. Clicking the link takes you to /reset-password/:token. Set a new password and click Reset password.
  5. You'll be redirected to /login to sign in with the new password.

If the email doesn't arrive:

  • Check spam / junk.
  • Ask an admin to confirm the email on file.
  • Try again, only the most recent reset link is valid.

Accepting a workspace invite

If a teammate invited you, you'll get an email with You've been invited to join <Workspace> on Flero and a link.

  1. Click the link. It takes you to /invite/:token.
  2. If you don't have an account yet, you'll be prompted to create one (same form as Sign up above, with the email pre-filled).
  3. If you already have an account, log in first; you'll be returned to the invite-acceptance step.
  4. Click Accept invite.
  5. You're dropped into the new workspace, ready to go.

Invites expire after 7 days by default. If yours has expired, ask the inviter to send a new one from Settings → Workspace → Team members.

Logging out

Click your avatar in the bottom-left of the sidebar → Log out. You'll be returned to /login. All other sessions remain active; to log out everywhere, see Security & MFA → Sessions.

Tips & gotchas

  • Email is the login key. You can't change it without admin intervention. Pick a stable address.
  • Password resets do not invalidate active sessions by default, combine with Log out all devices in Security if you suspect compromise.
  • MFA recovery codes are generated when you first enrol; store them somewhere safe. Losing both your second factor and recovery codes requires an admin to reset MFA for you.
  • Approval-pending accounts cannot log in at all until approved, there's no partial access. If you need urgent access, ping your admin.

Found something out of date? This page lives in the Flero docs content set.