Create account & first organization

This takes about 3 minutes. You'll create an account and set up an organization (the workspace where your projects and servers live).

Sign up

Three ways to create an account:

Email & password

1. Go to the registration page and enter your name, email, and password
2. Password needs: 8+ characters, one uppercase, one lowercase, one number
3. You'll be logged in immediately
4. Check your email and click the verification link

OAuth (GitHub, GitLab, Google, Microsoft)

1. Click the provider button on the login page
2. Authorize OEC.SH
3. Done. Your account is created and automatically verified.

This is the fastest option and also links your Git provider for later.

Passkeys

Passkeys (Face ID, Touch ID, Windows Hello, hardware keys) can't be used for initial signup. Create an account first with email or OAuth, then add passkeys in Settings > Security > Passkeys.

Create your organization

After your first login, the onboarding screen gives you two options:

Create a new organization - Enter a name (e.g., "Acme Corporation") and you're done. A URL-friendly slug is generated automatically. You become the Owner.

Join with an invitation - If someone invited you, either click the link from your email or enter the 6-character invitation code.

You can create multiple organizations later from the organization switcher in the sidebar.

Secure your account

These are optional but recommended, especially for production use.

Enable two-factor authentication

1. Go to Settings > Security
2. Click Enable 2FA
3. Scan the QR code with your authenticator app (Google Authenticator, Authy, 1Password, etc.)
4. Enter the 6-digit code to confirm
5. Save your 8 backup codes somewhere safe. You'll need these if you lose your phone.

Add a passkey

Passkeys let you log in with biometrics instead of typing a password.

1. Go to Settings > Security > Passkeys
2. Click Add Passkey
3. Name it (e.g., "MacBook Pro") and complete the biometric prompt

You can register multiple passkeys across devices.

Link additional OAuth providers

Go to Settings > Security > Connected Accounts to link GitHub, GitLab, Google, or Microsoft. This gives you backup login methods and makes Git integration smoother.

Account settings worth knowing about

Timezone (Settings > Preferences) - Affects how timestamps appear in deployment logs and backup schedules. Set this to your local timezone.

Notifications (Account > Notifications) - Control which events send you emails vs. in-app notifications. You can configure alerts for deployments, backups, and monitoring separately.

Profile (Account > Profile) - Update your name and avatar.

Common issues

"Account with this email already exists" - You probably signed up with OAuth before. Try clicking the GitHub/GitLab/Google button instead of registering with email.

Verification email not arriving - Check spam. Wait a few minutes. Add noreply@oecsh.io to your contacts. If still nothing, try a different email or use OAuth.

2FA code not working - Codes change every 30 seconds, so enter it right away. If your device clock is off, TOTP won't work. Use a backup code as a fallback.

Locked out after failed logins - Wait 15-30 minutes. Rate limiting resets automatically.

Can't create organization - Make sure you're logged in and have completed email verification (for email/password accounts).

Next steps

Your account and organization are ready. Continue with:

1. Add Your First Server - Connect a VPS or use shared servers
2. Set Up Storage - Configure backup storage
3. Create Your First Project - Connect a Git repo and pick an Odoo version

Or jump straight to the 10-minute deployment guide.