xsrv¶

Install and manage self-hosted services/applications, on your own server(s).

xsrv provides:

a comprehensive set of web applications/network services, system/infrastructure tools (roles)
a command-line tool for easy configuration, deployment and maintenance
a basic playbook to setup a single server in a few minutes

Roles¶

System components/infrastucture/middleware

common - common system components
backup - incremental backup service
monitoring - monitoring, alerting and logging system
apache - web server and PHP interpreter
postgresql or mariadb database server
openldap - LDAP directory server
docker - Docker container platform

End-user web applications/services

nextcloud - file hosting/sharing/synchronization/groupware/”private cloud” service
tt_rss - RSS feed reader
samba - cross-platform file and printer sharing service (SMB/CIFS)
shaarli - personal, minimalist, super-fast bookmarking service
gitea - lightweight self-hosted Git service/software forge
transmission - bittorrent peer-to-peer client web interface (seedbox) service
mumble - low-latency voice-over-IP (VoIP) server
rocketchat - realtime web chat/communication platform
jellyfin - media System that puts you in control of managing and streaming your media
homepage - simple homepage/dashhoard for your services

Quick start¶

# clone the repository
git clone https://gitlab.com/nodiscc/xsrv

# (optional) install the program to your $PATH
sudo cp xsrv/xsrv /usr/local/bin/

# initialize the playbook, provide basic settings and roles to enable
xsrv init-playbook

# deploy your first server
xsrv deploy

xsrv is a wrapper around the ansible suite of tools. Use the xsrv command-line tool to manage your servers, or include any of the roles in your own ansible playbooks. See Using as ansible collection.