First User Setup

The first user setup form, showing the email, name, avatar, password, and confirm password fields.

When a Trailer.dev instance has no users yet, the first thing you do is create the initial account. This account is created as an administrator.

When this page appears

The setup form is only available while the instance has zero users. The server endpoint backing it rejects requests once any user exists, and it is restricted to unauthenticated visitors.

1. Open your instance in a browser.
2. With no users present, you are redirected to the setup page at /first-steps.
3. If you have already created a user, this page is no longer reachable. Use the Login page instead.

What the form collects

The form has these fields:

• Email: used to log in. Up to 64 characters.
• Name: a display name for the account.
• Avatar: optional profile image.
• Password: at least 10 characters, and must include an uppercase letter, a number, and a special character (one of @ $ ! % * ? &).
• Confirm password: must match the password.

There is no username, email verification step, terms acceptance, or two-factor enrollment in this flow. The account is created already verified and with administrator rights.

Setup steps

1. Fill in your email and name.
2. Optionally upload an avatar.
3. Enter a password that meets the rules above and confirm it.
4. Submit the form.

On success you are logged in automatically and taken into the app. If the automatic login does not complete, sign in manually on the Login page.

After setup

• Continue with the Quick Start Guide to build an image and launch a workspace.
• Invite additional users and manage roles from the application once you are signed in.

Security tips

• Choose a strong password; this is the administrator account.
• If you forget the password later, use the “Forgot password” link on the Login page to request a reset email.