deploy-production

What problem does it solve?

Provides a clear, safety-first process to deploy the Renfield application to production servers while preventing device bricking, accidental secret leakage, and incorrect production frontend builds.

Core Features & Use Cases

• Safe file synchronization that excludes secrets and development artifacts, minimizing risk during code syncs to production.
• CPU-only backend rebuild workflow using Docker Compose for servers without GPUs and explicit instructions for building the frontend with a production target.
• Production secrets management guidance using file-based Docker secrets and Pydantic settings, plus satellite provisioning rules and ansible playbook usage to avoid SD card corruption on Pi Zero 2 W devices.
• Use Case: Deploy application updates to renfield.local, run database migrations, and provision or update voice satellites while avoiding service restarts that can brick devices.

Quick Start

Deploy Renfield to renfield.local by syncing code without secrets, rebuilding the backend with docker compose on the server, and building the frontend on the server using the production build target.