Proxy Apps

Reverse-proxy apps to an upstream (e.g., a Docker container).

Host vars (per app):

apps:
  - name: api                  # required
    type: proxy                # required
    domain: "api.example.com www.api.example.com"  # required
    user: deploy               # optional, defaults to first in users
    proxy_upstream: "http://127.0.0.1:3000"        # required
    acme_root: /var/www/letsencrypt                # optional
    cert: letsencrypt          # optional
    letsencrypt_email: admin@example.com          # required if cert=letsencrypt
    cronjobs:                  # optional
      - name: "Cleanup temp"
        job: "/usr/local/bin/cleanup-temp"
        schedule: "0 3 * * *"

Defaults:

  • user: first entry in users
  • acme_root: /var/www/letsencrypt
  • cert: unset