Aegis documentation

#Roadmap

What exists, what is next, and what is deliberately postponed.

#Done

  • Installer: verification, host requirements, toolchain, interactive setup,
  • dependency plan, build engine, patches, PECL extensions, verification markers.

  • All catalog applications build on Ubuntu 24.04 and 26.04 (x86_64), and on
  • aarch64 for the subset tested there (zlib, openssl, pcre2, beanstalkd).

  • keeper: service definitions, start/stop/restart/status, supervision loop,
  • boot hook, scheduled jobs (keeper.cron) with certificate renewal.

  • installer: verification, toolchain, interactive setup, builds — and now
  • the configure phase: every cube renders its configuration, bootstraps its databases and starts its service, followed by the keeper boot hook and a check that all services are up. aegis configure re-runs that phase alone.

  • ssl: local self-signed certificates with SANs, Let's Encrypt resolution,
  • multi-domain ensure_domains.

  • cubes: bind (config, zones, records, TSIG, journals), nginx
  • (configuration, baseline vhosts, vhosts, proxies, limits, real IP, GeoIP), certbot (ini files, issuance, listing), php (php.ini, FPM pools, extensions, published commands), postgresql and mariadb (bootstrap, config, platform role, databases), postfix (SQL maps, relays, security rules, hooks), dovecot (SQL auth, LMTP, IMAP), opendkim (per-domain keys, DNS publishing), postsrsd (socketmap SRS), mail (domains, mailboxes, aliases, forwards, storage).

  • Mail stack end-to-end: SMTP AUTH through Dovecot SASL, LMTP delivery,
  • DKIM signing with a published TXT record, SRS forward/reverse, catch-all and mail hooks running on matching messages.

  • End-to-end proof: Let's Encrypt certificate for a real domain issued
  • through BIND + TSIG, served by nginx over TLS.

  • Panel: accounts and sessions, every section of the platform, the same
  • services the CLI reads, live pages through Bird, and no write in a request — each one is a task.

  • tasker: one queue for every action, four execution types, plans with
  • ordered steps and on_failure rollback, retries through the queue with backoff, cooperative cancel and retry, a floating window with a bell, a live log on the task page.

  • Realtime: pulse samples the platform by area and bird forwards it to
  • the browser; the dashboard, Monitor, Network and the task log use the same transport.

  • Host permissions: ACL grants for the web account, with parent traversal,
  • a dry run, a check, a panel page and automatic use when a vhost serves a root that belongs to another account.

    #nginx — complete

    Everything below works and is tested on a live server: configuration rendering, validation, reload, keeper integration, baseline vhosts, vhosts (PHP/Laravel, TLS, limits, redirect, custom templates), proxies, tuning values, real client IP, GeoIP, expose, --json.

    Optional, deliberately off: brotli (module wants its brotli sources vendored) and upstream-fair (incompatible with nginx 1.30).

    #Next — platform

  • keeper.cron: jobs registered from the panel at run time (today a job needs
  • code); ssl-renew already runs with second precision.

  • Per-service resource limits (RLIMIT_NOFILE) before spawn, so
  • worker_connections 8192 stops warning.

  • ssl: pre-check that every requested domain has an authoritative zone, plus
  • --create-zones; reload consumers after renewal.

  • Configuration versioning in the panel database: every write keeps a version,
  • files stay the source of truth, the database is the undo history.

  • Tasker: scheduling from the panel ("run this nightly"), a per-task timeout
  • for internal actions, and a way to pause a queue while a service is down.

    #Later

  • Automated test suite: profiles, zones, certificate resolution, vhost rendering.
  • ARM validation for the remaining applications.
  • Packaging: install Aegis itself from a tarball with the runtime payload.
  • #Known gaps worth remembering

  • storage/data/apps/<app> ships with the code; it is not user data, even
  • though it lives under storage/.

  • Renewal runs from keeper.cron every six hours, with a 30-day window; a
  • certificate issued by an external client is not touched.

  • brotli and upstream-fair are not compiled into nginx today.
  • The installer still installs some -dev packages from the distribution
  • (libuv, libcap, lmdb, milter, libbsd); full independence would mean vendoring those libraries too.