Guides
Step-by-step tutorials and how-to guides for deploying applications with Hostess.
Welcome to the Hostess guides. Whether you're deploying your first app or configuring advanced features, these guides walk you through real-world scenarios step by step.
Tutorials
Complete walkthroughs that take you from zero to a running deployment.
Deploy Your First App
Install the CLI, create a hostess.yml, and deploy a Next.js app in under 5 minutes.
Deploy Your Second App
Deploy a FastAPI app with zero-config source builds and route-level metrics in Studio.
Migrate from Docker Compose
Convert an existing docker-compose.yml to hostess.yml and deploy to production.
Next.js + FastAPI + Postgres
Deploy a full-stack application with a React frontend, Python API, and managed database.
Deploy the Supabase Stack
Deploy the maintained Supabase example from howl-cloud/awesome-hostess.
Deploy the n8n Stack
Deploy the n8n workflow automation platform with a Postgres backend.
Deploy an Open LLM
Deploy Open WebUI with a private CPU-only llama.cpp model server.
Deploy the Cal.com Stack
Deploy Cal.com with managed Postgres, Redis, and SMTP configuration.
Deploy the Meilisearch Stack
Deploy Meilisearch with a public search UI and seeded demo index.
Deploy the Metabase Stack
Deploy Metabase with seeded business data and a registered demo data source.
How-To Guides
Focused guides for specific tasks and features.
Set Up Custom Domains
Configure DNS, add custom domains to your services, and verify TLS certificates.
Manage Secrets
Create, scope, sync, and compare secrets across environments.
Configure Autoscaling
Set up autoscaling with CPU-based targets.
Run Database Migrations
Use lifecycle hooks to run Alembic, Prisma, Django, or Drizzle migrations on deploy.
Set Up CI/CD with GitHub Actions
Automate deployments with GitHub Actions using personal access tokens.
Connect to Services Locally
Use hostess connect for local database access, shell sessions, and port forwarding.
Set Up Preview Environments
Deploy preview-style targets explicitly with the CLI and CI workflow filters.
Configure Backups & Restore
Schedule automatic backups and restore from snapshots.
Manage Teams & Permissions
Create organizations, invite members, and assign roles.
Deploy Specific Services
Deploy individual services in monorepos with the -s flag.