Getting Started
Bearicorn runs as a set of Docker containers — the app, the database, and optionally a web router for HTTPS. This page will help you choose your setup and get everything running.
Requirements
- A server with at least 2 GB of RAM
- SSH access
- A domain name (required for Caddy and Traefik HTTPS setups)
Choose your server
If you don't yet have a server, provision one first:
Then install Docker for your operating system:
- Debian / Ubuntu — recommended
- Fedora
- Alpine Linux
Choose your stack
| Stack | HTTPS | Best for |
|---|---|---|
| Caddy | Automatic | Most deployments — recommended |
| Direct | None | Internal networks or behind an existing reverse proxy |
| Traefik | Automatic | Multiple services on one server |
Configure DNS
For Caddy and Traefik, point your domain to your server before deploying. In your DNS provider, create an A record:
your-subdomain.example.com → <your server IP>DNS changes typically propagate within a few minutes. You can verify with:
bash
dig +short your-subdomain.example.com