auberge-0.14.21 is not a library.
Ansible-powered VPS management without Docker bloat
Auberge is a CLI tool for managing self-hosted infrastructure using Ansible automation. Deploy a full FOSS stack on a minimal VPS with no container overhead.
Features
- Minimal footprint: Runs on a 2GB RAM VPS (4GB recommended with Grimmory)
- No Docker bloat: Native systemd services
- Automated deployment: Ansible playbooks handle everything
- Declared versions: Every app and tool version pinned in the repo, kept fresh by Renovate, with
auberge versionsdrift reporting - Built-in backups: Full backup and restore with cross-host migration
- DNS management: Cloudflare integration
- SSH security: Multi-tier key management
Quick Start
Install Auberge from a pre-compiled binary or via cargo:
Add your VPS:
Deploy the full stack:
That's it! Auberge will configure your VPS with all infrastructure and applications.
What You Get
After deployment, your VPS will be running:
- Infrastructure: Caddy (reverse proxy), fail2ban (intrusion prevention), UFW (firewall)
- Networking: Blocky (DNS + ad-blocking), Headscale (coordination server), WireGuard, Tailscale
- Apps: Actual Budget (budgeting with bank sync), Baikal (calendar/contacts), Bichon (email archiving), Grimmory (digital library), Colporteur (newsletter-to-feed), FreshRSS (RSS reader), Gokapi (expiring-link file sharing), Navidrome (music), Paperless-ngx (document management), Syncthing (file sync), YOURLS (URL shortener)
- Notifications: TGTG Bot (Too Good To Go availability alerts via Telegram)
- AI Agents: Hermes Agent (self-improving personal AI assistant via Telegram)
Documentation
Full documentation available at auberge.sripwoud.xyz:
- Installation - Detailed setup guide
- First Deployment - Step-by-step walkthrough
- CLI Reference - All commands documented
- Backup & Restore - Data protection and migration
- Alternatives Comparison - How Auberge compares to other platforms
Requirements
- Linux or macOS (Windows is not supported — Ansible requires a Unix-based control node)
- A VPS with root/sudo access
- SSH connectivity to your VPS
- (Optional) Cloudflare account for DNS management
Philosophy
Auberge is selfware - software built to manage your self-hosted infrastructure:
- Lean and efficient
- No unnecessary abstractions
- Direct control over your services
- Transparent operations