How mother-of-all-self-hosting/mash-playbook works
MASH is an Ansible playbook for configuring and installing self-hosted services as Docker containers on user-managed servers. The main workflow is to prepare service configuration and run the playbook; Ansible applies the deployment to the server. The README documents a broad service catalog and automated installation and upgrades. The visible role tree contains base setup and migration tasks, while service-specific role implementations are not present in the supplied tree, so those are represented only at the documented level. The sampled Python utility optimizes playbook inputs from configured variables; its relationship to the deployment workflow is not established here.
Main entry points: optimize.py Playbook optimizer · main.yml Base setup · setup.yml MASH playbook · roles Service roles
Components 18
Deployment
- Service configuration
examples/vars.yml - MASH playbook
templates/setup.yml - Ansible
- Managed server
- Docker services
Playbook roles
- Service roles
roles - Base setup
roles/mash/playbook_base/tasks/main.yml - Base validation
roles/mash/playbook_base/tasks/validate_config.yml - Base directory
roles/mash/playbook_base/tasks/setup_base_dir.yml - Base user
roles/mash/playbook_base/tasks/setup_user.yml - Migrations
roles/mash/playbook_migration/tasks/main.yml - Supported services
docs/supported-services.md
Configuration optimization
- Playbook optimizer
bin/optimize.py - Variable files
- Role requirements
templates/requirements.yml - Filtered setup
templates/setup.yml - Filtered group vars
templates/group_vars_mash_servers
Other components
- Server operator
Connections 13
- Server operator → Service configuration: configures
README.md - Server operator → MASH playbook: runs
README.md - MASH playbook → Ansible: runs with
README.md - Ansible → Managed server: configures
README.md - Ansible → Docker services: installs
README.md - Service roles → Supported services: documents
- Playbook optimizer → Variable files: reads
bin/optimize.py - Playbook optimizer → Role requirements: filters
bin/optimize.py - Playbook optimizer → Filtered setup: writes
bin/optimize.py - Playbook optimizer → Filtered group vars: writes
bin/optimize.py - Base setup → Base validation: runs
- Base setup → Base directory: runs
- Base setup → Base user: runs