OpenReception Deployment

Ansible-based deployment for OpenReception with Docker Compose and Caddy reverse proxy.

Prerequisites

• Ansible - Automation tool for deployment
• Python with uv package manager - Python dependency management
• Remote server - RHEL-based Linux (Rocky Linux, AlmaLinux, CentOS Stream)

Quick Start

1. Clone the Repository

git clone <repo-url>
cd open-reception-setup

2. Install Dependencies

# Install Python dependencies
uv sync

# Install Ansible roles and collections
uv run ansible-galaxy install -r requirements.yml

3. Configure Your Deployment

Edit the following files to customize for your environment:

group_vars/all/vars.yml

• Admin SSH keys: Add/remove your team's public keys in user_setup_admins
• SMTP settings: Configure email settings for the application

group_vars/all/vault.yml

Generate secure values for secrets:

# Generate a 64-character password
pwgen 64 1

# Generate a 22-character salt
pwgen 22 1

Then encrypt the vault file:

uv run ansible-vault encrypt group_vars/all/vault.yml

templates/docker-compose.yml

Add your app services as needed.

templates/caddy/Caddyfile

Update the reverse proxy target to match your app's container and port.

templates/.env

Add your application's environment variables.

4. Set Up Inventory

Edit hosts.yml to add your target servers:

---
app:
  hosts:
    your-server.example.com:

5. Deploy

# Deploy the application
uv run ansible-playbook deploy-app.yml

Maintenance

Updating the Deployment

# Update images and restart
uv run ansible-playbook deploy-app.yml

Managing Vault Passwords

# Edit vault file
uv run ansible-vault edit group_vars/all/vault.yml

# Re-encrypt vault
uv run ansible-vault rekey group_vars/all/vault.yml