Settings

Status: Current

Last reviewed: 2026-05-13

Route: /settings

Settings contains account, UI, connection, and system information.

Account Tab

Session Info

Shows current username and role.

Change Username

1. Enter a new username.
2. Click Save name.

Validation:

• Username is required.
• Maximum length is 100 characters.
• Whitespace and control characters are not allowed.
• Duplicate username returns a conflict.

After a successful rename, the backend returns a fresh JWT and the frontend updates local session storage.

Change Password

1. Enter current password.
2. Enter new password.
3. Confirm new password.
4. Click Update password.

Validation:

• Current password is required.
• New password must be at least 8 characters.
• New password must be 256 characters or fewer.
• New password must differ from current password.
• Confirmation must match in the frontend.

Preferences Tab

Setting	Storage	Notes
Theme	next-themes storage	Light, system, or dark.
Refresh interval	nexus_refresh_interval	Options: 5s, 15s, 30s, 60s, or never.
Page size	nexus_page_size	Options: 10, 25, 50, or 100.

Preference changes are stored in browser local storage and broadcast to the current page via custom events.

Connections Tab

Display Endpoints

Field	Storage	Purpose
Display REST URL	nexus_display_rest_url	Human-facing REST endpoint reference.
Control endpoint	nexus_display_grpc_endpoint	Used when generating node agent environment blocks.

These settings do not change backend runtime addresses. They only control browser-side display and copy text.

Observability Links

Prometheus and Grafana values are read from frontend environment variables:

• NEXT_PUBLIC_PROMETHEUS_URL
• NEXT_PUBLIC_GRAFANA_URL

Registration Secret

The registration secret is stored in local storage as nexus_registration_secret and is submitted when creating nodes. It must match the backend registration secret if the backend has one configured.

System Tab

Shows:

• Frontend version from NEXT_PUBLIC_VERSION, or v0.1.0-alpha.
• Operational status label.
• Current resolved theme.