First run setup

Navigate to your deployment URL (for example https://bookmarks.example.com or http://localhost:5000 for a local trial).

Fill in:

• Email
• Name
• Password and Confirm Password — must match. Server-side rules (also applied on submit): at least 8 characters and at most 128, plus at least one uppercase letter, one lowercase letter, one digit, and one special character (common punctuation and symbols such as !@#$%; the API error text names the exact requirement if one is missing). If the UI only checks length until you submit, a password that is long enough but too simple can still be rejected.

Submit Create Admin User. The page notes that this user is an administrator and that you can configure OIDC later in admin settings.

On success you should see Setup completed successfully! and Redirecting to dashboard..., then land on the dashboard (/).

After setup, use Login at /login with the email and password you created. The /signup route exists for additional users when registration remains enabled (the default is on — see Configuration). Sign-up typically sends a verification email, so SMTP must be configured and working; lack of email delivery is a separate issue from REGISTRATIONS_ENABLED=false, which only blocks new registration entirely.

Open Admin (/admin) to reach tabs such as Users (/admin/members), Teams, OIDC Providers, Settings (SMTP and related options), and AI Suggestions. You can add OIDC providers, configure outbound email for password reset, and enable AI assistance when you have an OpenAI key.