Notifications & Two-Factor Auth
Email Notifications & Alerts
AODE can email you when important events happen. Configure this under Settings → Notifications & Alerts (admin only). This tab is also where SMTP delivery is set up — add an SMTP account so the portal can send mail.
You can toggle notifications for events including:
- Project Deployed — a project successfully deploys
- Project Failed — a deployment fails
- Project Stopped — a project is stopped
- Resource Alerts — CPU, memory, or disk thresholds are exceeded
- System Alerts — portal-level warnings and errors
- Backup Completed — a backup finishes
After adding an SMTP account, use the test option to confirm mail is delivered before relying on alerts.
Two-Factor Authentication (2FA)
Protect your account with TOTP-based two-factor authentication. Set it up under Settings → My Profile:
- Click Enable 2FA. A QR code is displayed.
- Scan the QR code with an authenticator app (Google Authenticator, Authy, 1Password, etc.).
- Enter the 6-digit code from your app to confirm and activate 2FA.
- On future logins you'll be prompted for a code after your password.
You can turn it off later with the Disable 2FA button on the same tab.
Updates
The Updates page (in the sidebar) keeps both the portal software and the underlying server patched, without touching the command line.
Portal Updates
When a new portal version is available, the page shows the version, release notes, and whether a database migration is required. Critical releases are flagged with a security notice. Click Start Update to apply it; the portal updates itself and restarts.
Host Security Updates
The Host Security Updates card applies OS-level security patches (apt) to the underlying VPS directly from the portal. Click to check for available security packages — the page lists how many are pending and which packages are affected. Apply them in one click. If the update requires a reboot, the page indicates that a reboot is needed.
Settings
The Settings page is organized into tabs. Tabs available depend on your role: General and My Profile are visible to all users, while Notifications & Alerts, Security, Backup, Users, Logs, Marketplace, and Dangerousare admin-only. Email/SMTP configuration lives under the Notifications & Alerts tab.
My Profile Tab (All Users)
GitHub Personal Access Tokens
Add, view, and manage multiple GitHub tokens for private repository access. Shows token name, masked token, creation date, and last used date.
Change Password
Click "Change Password" button to reveal form. Enter current password, new password, and confirm new password with show/hide toggles. Click "Change Password" to save or "Cancel" to close.
Two-Factor Authentication (2FA)
Click "Enable 2FA" to set up with QR code for authenticator app. When enabled, shows confirmation with "Disable 2FA" button available.
Users Tab
User list table with username, email, role (admin/user/viewer), active status, last login, created date. Add User button opens form with username, email, password, role fields. Edit button for each user to modify email, role, active status, or reset password. Delete user button with confirmation.
Logs Tab (Admin Only)
Two view modes: System Logs and User Activity Logs toggle.
System Logs
Container filter dropdown (all, portal, traefik, clickhouse). Log level filter (all, info, warning, error, success). Search box. Color-coded log lines by level. Formatted timestamp, level, and message.
User Activity Logs
User filter dropdown. Search box. Table with timestamp, username, action, category, expandable JSON details.
Dangerous Tab (Admin Only)
Admin-only access warning. Reset Database button (deletes all data except admin). Clear Logs button. Factory Reset button. Each action requires typing confirmation phrase in modal. Warning messages about irreversible actions.