# Hostess

> Docker Compose for Production — deploy your entire stack with a single `hostess.yml` file and a single command.

Hostess is a deployment platform that takes a `hostess.yml` configuration file and deploys your entire multi-service stack to the cloud, handling service discovery, managed databases, TLS certificates, and dependency ordering automatically.

## Documentation

- [AI Agents](https://docs.hostess.sh/docs/ai-agents.md): Use Hostess directly from Claude Code, Codex, Cursor, and other agents
- [Authentication](https://docs.hostess.sh/docs/authentication.md): Log in to Hostess, manage your session, and configure authentication for CI/CD pipelines.
- [CI/CD](https://docs.hostess.sh/docs/ci-cd.md): Automate deployments with continuous integration and delivery pipelines using Hostess.
- [CLI Reference](https://docs.hostess.sh/docs/cli.md): Complete reference for the Hostess command-line interface — your primary tool for deploying, managing, and monitoring applications on the Hostess platform.
- [Configuration Reference](https://docs.hostess.sh/docs/configuration.md): Complete reference for the hostess.yml configuration file — services, environments, resources, lifecycle hooks, and more.
- [Custom Domains](https://docs.hostess.sh/docs/custom-domains.md): Add custom domains to your services with automatic HTTPS via Let's Encrypt.
- [Environments](https://docs.hostess.sh/docs/environments.md): Target production, preview, staging, and custom environments with the CLI and configure per-environment domains.
- [Git Integration](https://docs.hostess.sh/docs/git-integration.md): Connect a GitHub repository to deploy automatically on push and get per-PR preview environments.
- [Introduction](https://docs.hostess.sh/docs.md): Hostess is a deployment platform that lets you deploy your entire stack — Next.js, FastAPI, Postgres, Redis, and more — with a single command.
- [Insights](https://docs.hostess.sh/docs/insights.md): Traffic, latency, error rates, and distributed traces for your services — on by default, with route-level detail one line of code away.
- [Installation](https://docs.hostess.sh/docs/installation.md): Install the Hostess CLI on macOS, Linux, or Windows and verify your installation.
- [Magic Variables](https://docs.hostess.sh/docs/magic-variables.md): Learn how Hostess magic variables enable zero-config service discovery, automatically wiring your services together without manual URL management.
- [Quick Start](https://docs.hostess.sh/docs/quick-start.md): Deploy a full-stack application with Hostess in under 5 minutes.
- [Secrets](https://docs.hostess.sh/docs/secrets.md): Learn how to securely manage environment variables, API keys, and credentials in Hostess using encrypted secrets with environment scoping and .env file syncing.
- [Service Visibility](https://docs.hostess.sh/docs/service-visibility.md): Control who can reach each service.
- [Hostess Studio](https://docs.hostess.sh/docs/studio.md): The web dashboard for managing your Hostess deployments, services, and configuration.
- [URL Routing](https://docs.hostess.sh/docs/url-routing.md): How Hostess generates and routes URLs for your services.
- [Authentication Commands](https://docs.hostess.sh/docs/cli/auth.md): Log in, log out, and show the current Hostess account from the CLI.
- [hostess backups](https://docs.hostess.sh/docs/cli/backups.md): Create, list, restore, and delete service backups for Postgres, Redis, and custom services.
- [hostess connect](https://docs.hostess.sh/docs/cli/connect.md): Create secure tunnels to services for local access, or open interactive shells inside running service instances.
- [hostess deploy](https://docs.hostess.sh/docs/cli/deploy.md): Deploy all services defined in hostess.yml to the Hostess platform.
- [hostess deployments](https://docs.hostess.sh/docs/cli/deployments.md): List, inspect, and remove deployments for your Hostess projects.
- [hostess domains](https://docs.hostess.sh/docs/cli/domains.md): Add and manage custom domains for your Hostess projects.
- [hostess environments](https://docs.hostess.sh/docs/cli/environments.md): Create, list, update, and delete Hostess project environments from the CLI.
- [hostess init](https://docs.hostess.sh/docs/cli/init.md): Convert an existing docker-compose.yml file into a hostess.yml configuration.
- [hostess jobs](https://docs.hostess.sh/docs/cli/jobs.md): Manage top-level jobs declared in hostess.yml.
- [hostess orgs](https://docs.hostess.sh/docs/cli/orgs.md): Manage organizations, team members, and invitations in Hostess.
- [hostess projects](https://docs.hostess.sh/docs/cli/projects.md): Create, list, and manage Hostess projects within your organizations.
- [hostess secrets](https://docs.hostess.sh/docs/cli/secrets.md): Manage encrypted secrets for your Hostess projects — add, edit, delete, sync, and compare across environments.
- [hostess services](https://docs.hostess.sh/docs/cli/services.md): List services in a deployment and stream service logs.
- [hostess update](https://docs.hostess.sh/docs/cli/update.md): Upgrade the Hostess CLI to the latest release.
- [hostess validate](https://docs.hostess.sh/docs/cli/validate.md): Validate your hostess.yml configuration locally before deploying.
- [Custom](https://docs.hostess.sh/docs/service-types/custom.md): Deploy any containerized application on Hostess using the custom service type — workers, proxies, ML models, and more.
- [FastAPI](https://docs.hostess.sh/docs/service-types/fastapi.md): Deploy FastAPI applications with automatic health checks, database migrations, and background workers on Hostess.
- [Next.js](https://docs.hostess.sh/docs/service-types/nextjs.md): Deploy Next.js applications with automatic build optimization, server-side rendering, and API routes on Hostess.
- [PostgreSQL](https://docs.hostess.sh/docs/service-types/postgres.md): Deploy fully managed PostgreSQL databases on Hostess with automatic backups, connection management, and scoped databases.
- [Redis](https://docs.hostess.sh/docs/service-types/redis.md): Deploy fully managed Redis instances on Hostess for caching, session storage, task queues, and real-time features.

## Guides

- [Configure Autoscaling](https://docs.hostess.sh/guides/autoscaling.md): Set up horizontal autoscaling with CPU-based targets for your services
- [Configure Backups and Restore](https://docs.hostess.sh/guides/backups-and-restore.md): Schedule automatic backups and restore from snapshots for your databases
- [Deploy the Cal.com Stack](https://docs.hostess.sh/guides/calcom-stack.md): Deploy the maintained Cal.com example from howl-cloud/awesome-hostess.
- [Set Up CI/CD with GitHub Actions](https://docs.hostess.sh/guides/ci-cd-github-actions.md): Automate Hostess deployments with GitHub Actions using personal access tokens
- [Connect to Services Locally](https://docs.hostess.sh/guides/connect-to-services.md): Use hostess connect for local database access, shell sessions, and port forwarding
- [Set Up Custom Domains](https://docs.hostess.sh/guides/custom-domains.md): Configure DNS, add custom domains, and verify HTTPS certificates for your services
- [Run Database Migrations](https://docs.hostess.sh/guides/database-migrations.md): Use lifecycle hooks to run Alembic, Prisma, Django, or Drizzle migrations on every deploy
- [Deploy Your First App](https://docs.hostess.sh/guides/deploy-your-first-app.md): Deploy a Next.js application with Hostess in under 5 minutes.
- [Deploy Your Second App](https://docs.hostess.sh/guides/deploy-your-second-app.md): Deploy a FastAPI app with zero-config source builds and route-level metrics in Studio.
- [Guides](https://docs.hostess.sh/guides.md): Step-by-step tutorials and how-to guides for deploying applications with Hostess.
- [Manage Secrets Across Environments](https://docs.hostess.sh/guides/managing-secrets.md): Create, scope, sync, and compare secrets across your deployment environments
- [Deploy the Meilisearch Stack](https://docs.hostess.sh/guides/meilisearch-stack.md): Deploy the maintained Meilisearch example from howl-cloud/awesome-hostess.
- [Deploy the Metabase Stack](https://docs.hostess.sh/guides/metabase-stack.md): Deploy the maintained Metabase example from howl-cloud/awesome-hostess.
- [Migrate from Docker Compose](https://docs.hostess.sh/guides/migrate-from-docker-compose.md): Convert your docker-compose.yml to hostess.yml and deploy to production.
- [Deploy the n8n Stack](https://docs.hostess.sh/guides/n8n-stack.md): Deploy the maintained n8n example from howl-cloud/awesome-hostess.
- [Deploy Next.js + FastAPI + Postgres](https://docs.hostess.sh/guides/nextjs-fastapi-postgres.md): Deploy a full-stack application with a React frontend, Python API, and managed database.
- [Deploy an Open LLM](https://docs.hostess.sh/guides/open-llm.md): Deploy the maintained Open WebUI and llama.cpp example from howl-cloud/awesome-hostess.
- [Deploy Specific Services](https://docs.hostess.sh/guides/per-service-deploys.md): Deploy individual services in monorepos using the -s flag for targeted builds
- [Preview Environments](https://docs.hostess.sh/guides/preview-environments.md): Deploy and operate preview-style environments explicitly in Hostess v1.
- [Deploy the Supabase Stack](https://docs.hostess.sh/guides/supabase-stack.md): Deploy the maintained Supabase example from howl-cloud/awesome-hostess.
- [Manage Teams and Permissions](https://docs.hostess.sh/guides/team-management.md): Create organizations, invite team members, and configure role-based access