Introduction

Auberge (French for inn) shelters your self-hosted services. It’s a Rust CLI that wraps Ansible to deploy a complete FOSS stack on a minimal VPS as plain systemd services, with no Docker layer underneath.

How it works

auberge CLI ─→ Ansible playbooks ─→ systemd services on the VPS

1. Define hosts in ~/.config/auberge/hosts.toml (or via auberge host add).
2. Set required values in config.toml (domain, secrets, …).
3. auberge deploy <app> runs the relevant playbooks via SSH.

Backups, DNS sync, and offsite restic snapshots are first-class CLI verbs.

What you get

Infrastructure: Caddy, fail2ban, UFW

Networking: Blocky, Headscale, Tailscale

Apps: Actual Budget, Baikal, Bichon, Grimmory, Colporteur, FreshRSS, Gokapi, Navidrome, Paperless-ngx, Stirling-PDF, Syncthing, YOURLS

Requirements

• Linux or macOS workstation (Windows: use WSL2)
• VPS with root/sudo access — 2 GB RAM minimum, 4 GB recommended with Grimmory
• (Optional) Cloudflare account for managed DNS

Philosophy

Selfware: direct control, no abstraction layers, transparent operations.

Continue: Quick Start · Installation · First Deployment