#The panel
The panel is a FastAPI application that reads the same configuration and databases as the command line, renders them with Jinja2, and turns every write into a task. It is the operator's view of the host, not a second source of truth: nothing exists in the panel that aegis cannot show.
aegis web-admin setup # dependencies, accounts, first adminaegis web-admin start # background, default 0.0.0.0:9981aegis web-admin statusaegis web-admin restart # what a deploy needsaegis web-admin passwd # change an account passwordweb_admin.host and web_admin.port in aegis.toml decide where it listens.
#Sections
| Section | What it answers |
|---|---|
| Dashboard | keeper, core daemons, applications, scheduled jobs, host, live charts |
| Monitor | realtime connections, nginx requests, mail deliveries |
| Network | interfaces, addresses, peers, ports |
| Web | nginx vhosts, cache, guards, PHP pools |
| DNS Manager | BIND, zones, records, repairs, history |
| domains, mailboxes, aliases, forwards, relays, hooks, service settings | |
| FTP Manager | vsftpd, virtual users, limits |
| Database | MariaDB, PostgreSQL, Redis: settings, databases, accounts, sessions |
| Storage | disks, usage, the two trees |
| SSL | certificates, issuance, renewal |
| Collector | the sampling daemons and their storage |
| Management | platform operations, one tab per subsystem (below) |
| Settings | configuration files and panel preferences |
| Apps | the catalog |
Evocati is not a sidebar row: the top bar carries it as a shield icon, next to the task bell, because it is opened while working elsewhere rather than as a destination of its own.
Management tabs: Overview, Keeper, WebSocket, Supervisor, Queue, SSH, Permissions, Cron, GeoIP, Tasker, Tools.
#Every write is a task
A form post validates what it can and stores a task; the tasker daemon does the work. That is true for vhosts and locations, mail domains, mailboxes, aliases, forwards, relays, hooks, the mail service settings, DNS zones, records and repairs, FTP users and settings, database objects and engine commands, and the permissions page.
The page redirects with task 42 queued, and the floating window reports the outcome. Nothing is written inside the request that asked for it, so a slow nginx -t or a database restart never blocks a browser tab. See tasker.md.
Pages that only read — dashboards, listings, one task's detail — stay synchronous. Check, Preview and similar read-only buttons also answer in the request; they queue nothing because they change nothing.
#Live updates
Pages that show moving numbers do not poll the database: the panel subscribes to the platform's WebSocket transport and re-renders what arrives. The browser asks /api/live for the connection details after it is authenticated, so the private token is never baked into a page. See live.md.
Pages that do not need a socket still refresh: the task window polls one small endpoint every 1.2 s.
#Authentication
aegis_session cookie; sessions have an expiry andare pruned, and every request resolves the account behind the cookie.
/assets/ is served no-cache on purpose: the panel is a set of ES moduleswith no version query, and a deploy must be visible after a plain reload.
#Assets and templates
| Path | Content |
|---|---|
app/modules/web_admin/templates | Jinja2 layouts and pages |
public/assets/web-admin/js | components, one file each, registered in app.js |
public/assets/web-admin/css | prebuilt CSS; a new utility class has no effect until it is added there |
config/ | aegis.toml plus one file per area, overlay server.toml |
CSS is compiled on a development machine and shipped; the panel does not build Tailwind at run time. A new utility class that is not already in app.css does nothing — use the existing classes or add plain CSS in both css/app.css and src/app.css.
#Sections that deserve their own page
that applies them.
#After a deploy
aegis web-admin restart # loads new routes, services and templatesA tasker action change additionally needs Management → Tasker → Restart tasker (or aegis keeper restart), because the daemon imports the action modules once, at start.