#Aegis — documentation
Aegis is a hosting platform: a PHP-free Python control layer that builds every piece of software it needs into its own tree, keeps those daemons alive, and manages their configuration from files that stay on disk.
#Start here
| Document | What it answers |
|---|---|
| installation.md | How to bring up a server from zero |
| architecture.md | How the code is organised and why |
| configuration.md | Every key in aegis.toml and server.toml |
| build-profiles.md | How an application is compiled and verified |
| schema.md | Every mail table: what it stores and who reads it |
| cli.md | Every command, with examples |
| keeper.md | How processes are supervised, restarted and judged hung |
| panel.md | The web panel: sections, task window, assets |
| tasker.md | Every action as a task: types, steps, retries, rollback |
| ai.md | Providers, models, agents, tools and the AI turn engine |
| permissions.md | ACLs for the web account, and the page that applies them |
| live.md | Bird and pulse: the realtime feed |
| api.md | The panel's JSON endpoints |
| panel-development.md | Routes, templates, components, task actions |
| writing-docs.md | How this manual is built and written |
| ssl-and-tls.md | Certificates: Let's Encrypt, local, SNI |
| cubes/bind.md | DNS cube |
| cubes/nginx.md | Web server cube |
| cubes/certbot.md | Certificate issuance cube |
| cubes/php.md | PHP and PHP-FPM cube |
| cubes/postgresql.md | PostgreSQL cube |
| cubes/mariadb.md | MariaDB cube |
| cubes/postfix.md | Postfix cube: parameters, services, security |
| cubes/postfix-relays.md | Several outbound IPs and routes |
| cubes/postfix-hooks.md | Scripts and webhooks per message |
| cubes/dovecot.md | Dovecot cube: IMAP, LMTP, SQL auth |
| cubes/opendkim.md | DKIM keys, signing, DNS records |
| cubes/postsrsd.md | Sender rewriting for forwarded mail |
| cubes/mail.md | Mail facade: domains, mailboxes, aliases |
| cubes/redis.md | Redis cache cube |
| cubes/beanstalkd.md | Beanstalkd queue cube |
| cubes/vsftpd.md | FTP cube with virtual users |
| cubes/supervisor.md | Supervisor cube for operator programs |
| cubes/tools.md | composer, git, ffmpeg, imagemagick |
| troubleshooting.md | Errors already seen and their fixes |
| roadmap.md | What is still missing |
#The ten-line quick start
# on your machineAEGIS_HOST=203.0.113.10 AEGIS_PASS='secret' ./bin/deploy.sh# on the servercd /etc/aegis./bin/aegis-prepare # bundled Python runtime./bin/aegis install # checks, prompts, then builds everything./bin/aegis keeper start # supervise the installed daemons./bin/aegis cubes nginx vhosts create --domain=example.com --location=php-mvc#Two trees, one rule
/etc/aegis — code. Relocatable: copy it anywhere, it still works./aegis — state: built applications, configuration, data, logs, sockets.Nothing in the code assumes /etc/aegis or /aegis; both come from configuration, with defaults derived from where the code sits.