Auberge

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 almost all apps together on 1GB RAM VPS
• No Docker bloat: Native systemd services
• Automated deployment: Ansible playbooks handle everything
• 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:

cargo install auberge

Add your VPS:

auberge host add my-vps 203.0.113.10

Deploy the full stack:

auberge ansible run

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), WireGuard, Tailscale
• Apps: Baikal (calendar/contacts), Colporteur (newsletter-to-feed), FreshRSS (RSS reader), Navidrome (music), Calibre (books), WebDAV (file sharing), YOURLS (URL shortener)

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

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

Community

• Documentation
• Report Issues
• Contributing