Invites and Registration
Odeion has no open registration. New accounts are created by redeeming an invite code, whether the user signs up with a password or through an OAuth provider.
Creating an Invite
Section titled “Creating an Invite”Mods and admins can create invites from Admin > Users. Each invite has:
| Property | Default | Description |
|---|---|---|
| Code | Generated | A random 32-character code. |
| Granted role | viewer | The role the new account receives. |
| Expiry | 7 days | How long the code can be redeemed. |
| Max uses | 1 | How many accounts the code can create. 0 means unlimited. |
Role Restrictions
Section titled “Role Restrictions”Who can create an invite for which role:
| Creator role | Can invite |
|---|---|
| Admin | viewer, curator, mod, admin |
| Mod | viewer, curator |
| Curator, Viewer | Cannot create invites |
Redeeming an Invite
Section titled “Redeeming an Invite”The invited person opens your server’s URL, chooses register, and enters the invite code with their desired username and password. Requirements:
- Username: 2 to 32 characters; letters, numbers, hyphens, and underscores only.
- Password: at least 8 characters.
To sign up with Google, Discord, or Apple instead, the person starts the OAuth login; for an unknown identity the flow asks for the invite code and a username, and no password is needed. See OAuth and SSO Providers.
Invite redemption attempts are rate limited per source IP to prevent code guessing.
Managing Invites
Section titled “Managing Invites”The Admin > Users page lists invites you created, with their expiry, use count, and remaining uses. Deleting an invite immediately stops further redemptions; accounts already created through it are unaffected.
The Registration kill switch blocks all account creation, even with a valid invite code.