AeroCopilotHelp Center

Creating Your Account

How to create an AeroCopilot account, what providers are available, and what happens after first sign-in including the redirect to onboarding.

Creating Your Account

Account creation is handled at /auth/sign-up. The page renders the sign-up methods configured for your environment and routes you through onboarding on first sign-in.

What you see on the sign-up page

The page shows:

  • A heading and subheading
  • The configured sign-up methods (SignUpMethodsContainer)
  • A terms-of-service checkbox if displayTermsCheckbox is enabled
  • A captcha widget if captchaTokenSiteKey is configured
  • An "Already have an account?" link to /auth/sign-in

The lastAuthMethod cookie remembers the provider you used previously, so returning users see their preferred method highlighted.

Supported sign-up methods

The available providers are determined by the authConfig.providers setting on the deployed instance. Authentication is implemented with Better Auth, which provides first-class multi-tenant organization support, RBAC, and built-in OTP. Whichever providers your instance enables — email/password, OAuth, magic link, or OTP — they appear as buttons in the sign-up container.

Optional URL parameters

The sign-up page accepts three query string parameters:

ParameterPurpose
emailPre-fills the email field, useful for invite links
redirectWhere to send the user after successful sign-up — sanitized via getSafeRedirectPath to prevent open redirects
lockedIndicates the account was locked, surfaced in the UI

All three are forwarded into the sign-in link at the bottom of the page so switching from sign-up to sign-in preserves context.

What happens after your first sign-in

  1. You land on /onboarding.
  2. The page server-checks your session — if missing, you are redirected to /auth/sign-in.
  3. If your User.onboardingCompleted flag is already true, you are redirected straight to /dashboard.
  4. Otherwise you see "Welcome to AeroCopilot — Let's set up your profile in under 2 minutes" and the wizard renders.

This means the onboarding wizard runs exactly once — it cannot be re-entered after completion via this URL.

Email verification

If your environment uses email/password sign-up, follow the verification email after creating your account. Other providers (OAuth, OTP) verify email implicitly through the provider.

Sign-in versus sign-up

If you already have an account, use /auth/sign-in instead. The sign-up page provides a one-click switch via the "Already have an account?" link, preserving any email, redirect, or locked parameters from the URL.

Troubleshooting

  • The terms checkbox is not visible — your instance has displayTermsCheckbox disabled. The application terms still apply per the Terms of Service link in the footer.
  • The captcha is required and you cannot solve it — refresh the page to load a new challenge. If captcha consistently fails, contact support.
  • You are redirected back to sign-in immediately — your session was not established. Check that third-party cookies are allowed for the domain.

Next step

After your account is created and you sign in, you are routed to the onboarding wizard. See Quick Start for the full first-flight walkthrough.