xsrv

xsrv is an Ansible-based collection of roles, playbooks and utilities designed to install, manage and run a wide range of self-hosted network services and applications on your own servers. It provides modular roles, an optional command-line controller and templates to bootstrap a single-server project quickly.

Key Features

• Modular Ansible roles for many services (web server, mail, VPN, databases, media, collaboration and more) so components can be deployed independently.
• Optional command-line controller with utilities for common tasks (provisioning VMs, initializing templates, applying changes and upgrades).
• Built-in templates and example inventory to get a single-server deployment up quickly and reproducibly.
• Integration with libvirt for automated VM provisioning and with common OS/stack tooling used on Debian-based hosts.
• Centralized configuration via role variables and a documented list of configuration variables to control deployments and service options.
• Role-level maintenance and upgrade procedures; guidance for TLS certificate acquisition and DNS requirements for public services.

Use Cases

• Deploy and operate a personal or small-team self-hosted server running Nextcloud, Gitea, Matrix, Jitsi, media servers and similar applications.
• Create reproducible lab or test environments by provisioning Debian VM templates and automated roles via libvirt/Ansible.
• Manage ongoing maintenance, upgrades and role-based configuration for multiple Debian hosts from a single Ansible controller.

Limitations and Considerations

• Focused on Debian-based systems: documentation and many roles assume Debian/Ubuntu packaging and tools; non-Debian platforms will require manual adaptation.
• Requires familiarity with Ansible and SSH-based controller/host workflows; not a turnkey graphical control panel — operations are performed via playbooks and CLI tools.
• Services and resource usage depend on installed roles; plan CPU, RAM and storage per role and follow role-specific guidance for production use.

xsrv is intended for users who prefer infrastructure-as-code and reproducible Ansible-driven deployments for self-hosting. Its modular role approach makes it suitable for incremental adoption and custom configurations.