Self-host Install
AliasVault is self-hosted with Docker. Both methods install the same AliasVault, they differ only in how much is managed for you versus how much fits into infrastructure you already run. Pick the one that matches your setup.
Install Script
A fully managed setup. One script spins up multiple containers, handles HTTPS for you, and gives you CLI helpers for updates and maintenance.
- AliasVault on its own VPS or LXC
- Automatic HTTPS via Let's Encrypt
- Guided updates & migrations
- Production-ready defaults
Best for a fresh VM or VPS dedicated to AliasVault.
Docker Compose
A single all-in-one container you can add to your existing Docker stack. You bring your own reverse proxy and TLS, and keep full control.
- AliasVault as an all-in-one container on your existing Docker host
- Best for setups on NAS or when using tools like e.g. Portainer
- Bring your own TLS (Traefik, Nginx, HAProxy, Caddy…)
- Updates via
docker pull(occasional manual migrations)
Best for a NAS or homelab that already runs a reverse proxy and/or other Docker containers.
Side-by-side comparison
Both methods run the same AliasVault version. They differ mainly in how TLS, updates, and the surrounding setup are handled.
| Install Script | Docker Compose | |
|---|---|---|
| TLS / HTTPS | Automatic via Let's Encrypt | Bring your own reverse proxy |
| Updates | Guided via install.sh | Manual docker pull + migrations |
| Architecture | Multiple containers (one per service) | Single all-in-one image |
| Reverse proxy | Included & configured | You provide (Traefik, Nginx, Caddy…) |
| Build from source | Supported | Pre-built image only |
| Best for | Dedicated VM / VPS | Existing homelab / NAS |
Both methods use the same Docker bind-mount directories (/database, /certificates, /logs, /secrets), so migration is straightforward. Stop or uninstall one method, then follow the installation steps for the other. Your data stays preserved.
Frequently Asked Questions
What are the system requirements?
Minimum:
- 64-bit Linux OS (Ubuntu or RHEL-based recommended)
- 1 vCPU, 1 GB RAM, 16 GB disk
- Docker CE (≥ 20.10) and Docker Compose (≥ 2.0)
Network:
- Ports 80 and 443 available
- Optional: ports 25 and 587 for private email domains