Aegis documentation

#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

DocumentWhat it answers
installation.mdHow to bring up a server from zero
architecture.mdHow the code is organised and why
configuration.mdEvery key in aegis.toml and server.toml
build-profiles.mdHow an application is compiled and verified
schema.mdEvery mail table: what it stores and who reads it
cli.mdEvery command, with examples
keeper.mdHow processes are supervised, restarted and judged hung
panel.mdThe web panel: sections, task window, assets
tasker.mdEvery action as a task: types, steps, retries, rollback
ai.mdProviders, models, agents, tools and the AI turn engine
permissions.mdACLs for the web account, and the page that applies them
live.mdBird and pulse: the realtime feed
api.mdThe panel's JSON endpoints
panel-development.mdRoutes, templates, components, task actions
writing-docs.mdHow this manual is built and written
ssl-and-tls.mdCertificates: Let's Encrypt, local, SNI
cubes/bind.mdDNS cube
cubes/nginx.mdWeb server cube
cubes/certbot.mdCertificate issuance cube
cubes/php.mdPHP and PHP-FPM cube
cubes/postgresql.mdPostgreSQL cube
cubes/mariadb.mdMariaDB cube
cubes/postfix.mdPostfix cube: parameters, services, security
cubes/postfix-relays.mdSeveral outbound IPs and routes
cubes/postfix-hooks.mdScripts and webhooks per message
cubes/dovecot.mdDovecot cube: IMAP, LMTP, SQL auth
cubes/opendkim.mdDKIM keys, signing, DNS records
cubes/postsrsd.mdSender rewriting for forwarded mail
cubes/mail.mdMail facade: domains, mailboxes, aliases
cubes/redis.mdRedis cache cube
cubes/beanstalkd.mdBeanstalkd queue cube
cubes/vsftpd.mdFTP cube with virtual users
cubes/supervisor.mdSupervisor cube for operator programs
cubes/tools.mdcomposer, git, ffmpeg, imagemagick
troubleshooting.mdErrors already seen and their fixes
roadmap.mdWhat is still missing

#The ten-line quick start

bash
# 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.