azerioid-stack-manager README

The project's README from github.com/azerioid/azerioid-stack-manager. As one markdown file: README.md.

AZERIOID Stack Manager

One host. One panel. A full Linux web stack you control.

AZERIOID Stack Manager is a self-contained stack manager and web control panel for operators who run sites on a single Linux server. One installer bootstraps Caddy, a dedicated PHP 8.4 FPM pool, and a SQLite-backed admin UI on Laravel 13 + Livewire 4. Everything else — Nginx, Apache, databases, cache, PHP site runtimes, Node.js, Supervisor, mail, rootless Docker — installs on demand from the dashboard or the matching CLI, using official upstream packages.

Built for VPS and bare-metal operators who want a clean bootstrap, a real UI for day-two work, and a privileged broker that keeps package installs and host changes out of the web app process.

Screenshots

Captured from a live Ubuntu 24.04 panel host (UI anonymized where needed). Reflects the post–v1.6 Virtual Hosts redesign and current Mail / runtime pages.

Overview Virtual hosts
Overview Virtual hosts
Virtual hosts · row actions Docker runtime filter
Virtual hosts actions Docker vhosts
Mail Databases
Mail Databases
Terminal File Manager + editor
Terminal File Manager
Components Security
Components Security

What ships out of the box vs on demand

Bootstrap (automatic)

Piece Role
Caddy Panel vhost on port 3169; front door on :80/:443 for sites
PHP 8.4 FPM Dedicated panel pool — isolated from site PHP versions
SQLite Panel state under /var/lib/azerioid-panel/
Broker Privileged host driver (sudoers); UI never runs apt/dnf itself
Queue worker Background component install/remove jobs

On demand (Components page or azerioid component)

Category Components
Web engines Nginx, Apache (loopback backends; Caddy terminates TLS)
Databases MariaDB, PostgreSQL, MongoDB
Cache / KV Redis, Memcached
Runtimes PHP 8.1–8.3 (site pools); Node.js 20 / 22 / 24
Process manager Supervisor (programs run as azerioid-supervised, never root)
Per-vhost app runtimes Opt-in: PHP-FPM (default), Laravel Octane / FrankenPHP, PM2 Node cluster, rootless Docker — chosen at create time or enabled later
Mail Postfix + Dovecot + OpenDKIM (opt-in; authenticated submission only, virtual mailboxes, DKIM/SPF/DMARC guidance, direct or smarthost outbound)
Tools Adminer (panel session–gated SQL UI; MariaDB / PostgreSQL / SQLite — not MongoDB)

Feature highlights

Proven on supported distros in operator testing — not marketing vapor:

Honest limits: single admin (no multi-user RBAC yet). Archive extract is not offered in the File Manager (zip-slip scoped out). Mail ships without webmail, spam filtering, quotas, or catch-all addresses; deliverability still depends on reverse DNS you set at your VPS provider. Octane is Laravel-only; PM2 is Node-only; Docker compose host mounts are bounded by what azerioid-supervised can already access (not equivalent to root).

Supported operating systems

Verified end-to-end on the current stack (Laravel 13 + Livewire 4, including mail / Octane / PM2 / rootless Docker paths where those features apply):

OS Support Notes
Ubuntu 24.04 Supported Verified
Debian 12 / 13 Supported Verified
AlmaLinux 9+ Supported Verified with SELinux Enforcing
Rocky Linux 9+ Supported Verified with SELinux Enforcing (same EL path as AlmaLinux)
CentOS Stream 9+ Supported Verified with SELinux Enforcing (same EL path; ID=centos)
RHEL / Oracle Linux 9+ Supported (same EL path) Same installer/SELinux helpers
Fedora Not supported Installer refuses correctly

Requirements: root, outbound HTTPS, git.

Quick start

git clone https://github.com/azerioid/azerioid-stack-manager.git stack-manager && cd stack-manager
chmod +x stack-manager.sh
sudo ./stack-manager.sh

Interactive install (TTY) prompts for:

Non-interactive example:

sudo ./stack-manager.sh --non-interactive --access=public --create-admin=true [email protected]
# Set ADMIN_PASSWORD in the environment — never pass passwords on argv

Tunnel access after a default install:

ssh -L 3169:127.0.0.1:3169 user@host
# open http://127.0.0.1:3169/setup  (or /login if an admin was created)

Optional hardening flags: --firewall=true, --fail2ban=true, --require-totp=true. Full list: sudo ./stack-manager.sh --help.

On any public install, change the admin password immediately after first login if you used a weak or default value.

Security model (brief)

Details: docs/SPEC.md, docs/DECISIONS.md, docs/port-ownership.md.

CLI examples

azerioid status
azerioid vhost list --json
azerioid vhost add --domain=app.example.com --type=php --php=8.4 --root=/data/www/app.example.com --tls=auto
azerioid vhost add --domain=api.example.com --type=php --php=8.4 --runtime=octane --tls=auto
azerioid vhost octane enable --domain=api.example.com
azerioid vhost octane reload --domain=api.example.com
azerioid vhost pm2 enable --domain=node.example.com --instances=2 --entry=server.js
azerioid vhost docker enable --domain=app.example.com --mode=image --image=nginx:alpine --internal-port=80
azerioid db add --engine=mariadb --name=appdb --user=appdb
azerioid component install redis
azerioid component install mail   # refuses foreign Exim/Sendmail unless --option=confirm=REPLACE-MTA
azerioid component install adminer
azerioid process create --vhost=app.example.com --command='node server.js' --name=app-node
azerioid mail hostname set --hostname=mail.example.com
azerioid mail domain enable --domain=app.example.com
azerioid mail mailbox add [email protected]   # password printed once
azerioid mail status   # “Direct mail delivery: available” or “…blocked… configure a relay”
azerioid mail smarthost set --host=smtp.provider.example --port=587 --username=apikey
# relay password: AZERIOID_RELAY_PASSWORD=… (never argv)
azerioid mail dns --domain=app.example.com
azerioid panel update check
azerioid panel update apply --v=v1.6.0 --confirm

Secrets (DB passwords, DNS tokens, backup passphrase, TOTP re-auth, mail/smarthost passwords) go through the environment or one-time stdout — not argv flags. Full surface: azerioid help.

Uninstall

Panel only:

sudo ./deploy/uninstall.sh --drop-db --remove-bootstrap

Full teardown (panel + broker-managed components + added repos). Intentionally retains site trees under /data/www and panel/broker logs under /var/log/azerioid-panel (audit trail after reinstall):

sudo ./deploy/uninstall.sh --full

License

MIT — see web/composer.json.

Contributing

Issues and pull requests: azerioid/azerioid-stack-manager. Architecture decisions live in docs/DECISIONS.md; keep ADR history intact when proposing changes.

azerioid-stack-manager (azerioid/azerioid-stack-manager)

Searching Database…

710 ·GitHub
Azerioid-stack-manager
Что это?AZERIOID Stack Manager — автономный менеджер стека и веб-панель управления для операторов, держащих сайты на одном Linux-сервере. Он разворачивает Caddy, выделенный пул PHP-FPM и админский интерфейс на SQLite, а затем позволяет по мере надобности добавлять веб-серверы, базы данных, кэш, почту, Node.js и rootless Docker.
Это библиотека для кода или отдельное серверное приложение?Это отдельное селф-хостед веб-приложение плюс соответствующий CLI (azerioid), построенное на Laravel 13 + Livewire 4 с базой панели на SQLite, а не библиотека для импорта в другой проект.
Как запустить его на своём сервере?Запустите интерактивный установщик с root-правами (sudo ./stack-manager.sh): он спросит режим доступа (туннель или публичный), порт панели, TOTP, файрвол и fail2ban; для установки скриптами поддерживаются и неинтерактивные флаги.
Что нужно серверу перед установкой?Нужны root-доступ, исходящий HTTPS и git. Работает на Ubuntu 24.04, Debian 12/13, AlmaLinux/Rocky/CentOS Stream 9+ и RHEL/Oracle Linux 9+; Fedora явно не поддерживается.
Каковы текущие ограничения?Мультипользовательского RBAC пока нет (только один админ), распаковка архивов намеренно не включена в Файловый менеджер, а комплектный почтовый сервер поставляется без веб-почты, спам-фильтра, квот и catch-all адресов.
Для кого это создано?Для операторов VPS и «железных» серверов с одной Linux-машиной, которым нужны чистый начальный разворот и настоящий интерфейс «второго дня» для сайтов, баз, почты и процессов, вместо ручного писания конфигов.
Работает ли он на любом Linux-дистрибутиве?Нет — проверено на Ubuntu 24.04, Debian 12/13, AlmaLinux 9+, Rocky Linux 9+, CentOS Stream 9+ и RHEL/Oracle Linux 9+ (EL-путь с принудительным SELinux); установщик явно отказывается работать с Fedora.
Секреты вроде DNS-токенов и паролей в безопасности?API-токены DNS-01 и секреты почты/smarthost хранятся только для root и никогда не принимаются через аргументы командной строки; остальные секреты передаются через окружение или одноразовый stdout.
Что можно доустановить по запросу сверх базового стека?Со страницы Components или через CLI azerioid можно добавить Nginx или Apache, MariaDB/PostgreSQL/MongoDB, Redis/Memcached, рантаймы PHP 8.1-8.3 или Node.js 20/22/24, Supervisor, полный почтовый стек (Postfix+Dovecot+OpenDKIM) и rootless Docker.
Как настраивается HTTPS для моих сайтов?TLS терминируется Caddy, которая поддерживает автоматический Let's Encrypt HTTP-01, самоподписанный/внутренний TLS и DNS-01 через Cloudflare или DigitalOcean (протестировано слабее, чем внутренний TLS).
Может ли каждый сайт работать на своём движке или рантайме?Да — каждый виртуальный хост независимо выбирает Caddy, Apache или Nginx как движок и может вместо стандартного PHP-FPM включить Laravel Octane (FrankenPHP), cluster-режим PM2 для Node или rootless Docker.
Панель по умолчанию открыта в интернет?Нет, режим доступа по умолчанию — туннель на localhost (127.0.0.1:3169); публичный HTTPS на IP хоста — явный выбор при установке.
What are similar projects?caprover, acme.sh, docker-mailserver, mailcow-dockerized, speedtest, dokploy, all-in-one, nginxconfig.io
Which topics is it in?mailserver, process-manager, totp, admin-panel, letsencrypt, apache, nginx, web-server, mariadb, firewall, vps, homelab
Creator
azerioid
Size
6.3 MB
Stars
710
Updated
CommitOct 12Releasev2.14.5Oct 07
Age
1mo
Commits · 90 Days