Audience: Admin
Settings (toolbar title Settings, panel Application settings) controls workspace-level preferences.
| Audience | What you use |
|---|---|
| All signed-in users | General — Debug mode |
| Administrators | AI, Store, Server, Security, Contact, Pages |
This is separate from Project Settings (per-project auth secret, theme, SMTP, and more).
Warning
Admin tabs can lock users out, break uploads, or invalidate sessions. Change deliberately.
| Role | Purpose |
|---|---|
| Content author | Toggle Debug mode when diagnosing builder issues |
| Administrator | Configure AI, Store URL, server, security, contact relay, and global pages |
Open Settings from:
📷 Settings tabs
Image Path:
images/settings-tabs.png
Alt Text:
Settings page with General and admin configuration tabs
Caption:
Application settings organized by tab.
| Setting | Purpose |
|---|---|
| Debug mode | Show additional diagnostics in the builder and runtime |
Save with Save General when the header save control appears.
| Setting / action | Purpose |
|---|---|
| AI URL | Base URL for the AI server |
| Instance id | Assigned on register (read-only) |
| Register → Register with AI | Push this LokAkrt key and JWT secret to the AI server |
| Rotate secret → Rotate AI secret | Push the current LokAkrt JWT secret to the AI server without changing the local secret first |
The builder talks to the AI server directly. Register this LokAkrt so customer JWTs can be verified there.
The assistant asks project-specific questions rather than reading the whole project, so a small model works; a larger one only gives richer page designs.
Model choice is not on this tab. Authors pick an enabled model in the builder AI composer. Operators configure profiles, Host/Model, pricing, and the default model in the AI operator Settings (ui/ai, typically port 5200).
Project-level AI assistant rules and Allow sample rows live under Project settings, not here.
| Setting | Purpose |
|---|---|
| Store URL | Base URL for the store server used for pack listings, pack details, and images |
Leave empty to disable the marketplace. The browser and this LokAkrt must both be able to reach it. Saving reloads so the page can load store images.
Expected result after save: Plugins → Store can load pack listings when the URL is valid and reachable.
Tip
An empty or unreachable Store URL shows marketplace disabled / unavailable states on the Store page — not a Plugins bug.
| Setting | Purpose |
|---|---|
| Developer mode | When enabled, publishing a template also writes its definition file to the authoring module, migration pack, or shared template store. Off = database only. |
| Disable recovery login | When checked, empty-email login with the administration token is rejected. Does not affect the setup wizard. Unchecked = recovery allowed (default). |
| Public base URL | Canonical API / site origin. Used for relative data-source fetches, client export, and training fallbacks. |
| Max request body | Express JSON body limit — applied at Express startup; restart after save |
| LokAkrt slug | First URL segment for admin and static marketing pages (for example /lokakrt/dashboard). Homepage stays at /. Reload the browser after changing. |
JWT, CORS, public project definition, metrics/status restrictions, scrape token, and auth / public-data rate limits. Changing the JWT secret signs everyone out. Some changes need an API restart.
| Setting | Purpose |
|---|---|
| Relay project | Project whose email server sends contact submissions |
There is no platform-level SMTP here. Public /contact submissions are always recorded as email jobs on that project; delivery fails until its Email Server settings (project edit) are configured.
Shortcuts to edit global system pages (auth failures and missing routes). Edits apply workspace-wide for projects using the global default.
See Pages.
| Action | User | Admin |
|---|---|---|
| Open Settings → General | Yes | Yes |
| Open admin tabs (AI, Store, Server, Security, Contact, Pages) | — | Yes |
| Problem | Cause | Solution |
|---|---|---|
| Only see General | Not Admin | Expected for authors |
| Store listings empty / disabled | Missing or unreachable Store URL | Set Store URL; confirm browser and server can reach it |
| Change ignored | Restart required | Restart API as noted on Server / Security |
| Users logged out | JWT secret changed | Expected; communicate re-login |
| AI unavailable | AI URL / registration | Check AI tab and Server status |
| Contact form never delivers | Relay project SMTP missing | Configure Email Server on the relay project |