Choosing a Deployment Method
This page only helps you choose a path
The complete deployment documentation now lives under Deployment Overview. This page remains as a short entry point so old links and deployment links from the user guide land on the same selection page.
For local use, LAN use, or a temporary trial, go straight to Getting Started.
For long-term operation, a domain name, HTTPS, backup, and upgrades, start from Deployment Overview.
Choose a Runtime First
| Method | Best for | Next step |
|---|---|---|
| Docker | NAS devices, home servers, small teams, existing container environments | Docker Deployment |
| Docker follower node | Connecting another AsterDrive instance as a remote storage backend | Docker Follower Node |
| systemd | Cloud servers, physical machines, long-term stable operation | systemd Deployment |
| Direct binary run | Local tests and temporary validation | Getting Started |
For a first deployment, prefer Docker. For long-running Linux servers, prefer systemd.
What to Confirm Before Launch
A production deployment is more than starting a container. Confirm these items first:
- Data directory:
config.toml, the database, and the local upload directory must survive upgrades and restarts - Access path: the public entry point should provide HTTPS through a reverse proxy
- Public site URL: shares, mail, WOPI, and cross-origin access all depend on it
- WebDAV: if Finder, Windows, rclone, or sync tools will use it, the proxy layer must pass the required methods and upload sizes
- Storage location: local disk, S3 / MinIO, and follower nodes each have different maintenance costs
- Backup and restore: verify the backup and restore flow before launch, not after a failure
These topics are covered in order in Deployment Overview. This page only keeps the selection path.
Common Next Steps
- Want to get it running first: read Getting Started
- Want to launch for real: read Deployment Overview
- Want HTTPS: read Reverse Proxy
- Want to confirm what startup completed automatically: read First-Start Checklist
- Want command-line checks, offline configuration, or cross-database migration: read Operations CLI
- Want backup and restore: read Backup and Restore
- Want to upgrade: read Upgrades and Version Migration
- Want a remote storage backend: start with Follower Nodes