Setup wizard¶
After the stack starts for the first time, the first-run wizard runs in the browser. It opens automatically when you hit the server URL.
(or the IP if no domain)
Steps¶
1 — Language¶
German or English. Switchable per-user later in preferences.
2 — Admin user¶
Email and password for the first super admin. This account can't be deleted later unless another super admin exists.
The email must be deliverable
The first super admin gets 2FA codes via email. If the address isn't reachable, you're locked out. SMTP comes later in the wizard, but test email delivery before enabling 2FA.
3 — Tenant¶
First tenant. For MSP use: one per customer. For single-org use: one tenant called „Internal" is enough.
Add more tenants later: Admin → Tenants → New.
4 — Sizing¶
Since v0.17.3
The wizard asks for expected instance size between SMTP and license.
| Profile | Hosts | Hardware recommendation |
|---|---|---|
| Small | < 50 | 2 GB RAM, 1 core |
| Medium | 50–500 | 4 GB RAM, 2 cores |
| Large | 500–2 000 | 8 GB RAM, 4 cores |
| XL | > 2 000 | 16 GB RAM, 8 cores |
The choice is stored in system_settings.size_profile for later auto-tuning. Currently the wizard doesn't apply tuning automatically — values are advisory. Active tuning ships in a later update.
Scaling details: Administration → Scaling.
5 — SMTP (optional)¶
For email notifications and 2FA codes:
| Field | Example |
|---|---|
| Host | smtp.example.com |
| Port | 587 (STARTTLS) or 465 (SMTPS) |
| User | noreply@example.com |
| Password | App password, not personal account password |
| From | Vesana <noreply@example.com> |
Test email button validates the config immediately.
If you skip SMTP, 2FA and email alerts are off. Push notifications still work.
6 — License (optional)¶
License key in format OVS-XXXX-XXXX-XXXX. For Community, leave empty.
Add later under Admin → License.
Details: License tiers.
7 — Localhost monitoring (optional)¶
Activates a few default checks on the stack itself (CPU, memory, disk, container service status). Recommended: enable — you see something in the dashboard immediately.
8 — Summary¶
All inputs summarized, then „Finish setup". You land at the login.
Skipped wizard — restart¶
If the wizard was accidentally cancelled, you can re-open it under https://your-domain.tld/setup as long as no admin is yet created.
Once an admin exists, /setup redirects to login automatically.
Tester mode¶
Tester mode
With VESANA_TESTER_MODE=true in .env, the wizard skips the license step automatically. All features are unlocked, the server registers with the licence portal as a tester instance.
Details: Self-hosting → Tester mode.