Advanced Usage

Custom Templates

Add custom configs in .deployment/templates/:

• .deployment
  • templates
    • nginx
    • services

All templates support Jinja2 syntax and have access to environment variables.

Custom Nginx Configuration

Example: Create .deployment/templates/nginx/my-app.conf.j2

server {
    listen 80;
    server_name {{ domain }};
 
    location / {
        proxy_pass http://localhost:{{ app_port }};
        proxy_set_header Host $host;
    }
}

Custom Systemd Service

Example: Create .deployment/templates/services/my-worker.service.j2

[Unit]
Description={{ service_description }}
After=docker.service
 
[Service]
Type=simple
ExecStart={{ script_path }}
Environment="ENV={{ env }}"
Restart=always
 
[Install]
WantedBy=multi-user.target

For custom scripts that run during deployment, see Hooks.