> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Guides and Blueprints

> Architecture patterns and how-to guides for Fly.io: per-user Machines, AI agents, MCP servers, deployments, private networking, scaling, and background jobs.

A growing library of guides for running, designing, and deploying all kinds of apps on Fly.io. Whether you're just getting started or looking for new ideas, these are real-world patterns you can learn from and build on.

## Architecture Patterns

Guides for the structure your app on Fly.io. Layouts, tradeoffs, moving parts.

* [Deploy OpenClaw on Fly.io](https://docs.fly.io/blueprints/deploy-openclaw.md)
* [Run Hermes Agent on Fly.io](https://docs.fly.io/blueprints/hermes-agent-on-fly-io.md) NEW!!
* [Warm pools of user Machines](https://docs.fly.io/blueprints/warm-pool-user-machines.md) NEW!!
* [Deploying Remote MCP Servers](https://docs.fly.io/blueprints/remote-mcp-servers.md)
* [High availability: run multiple Machines](https://docs.fly.io/blueprints/resilient-apps-multiple-machines.md)
* [N-tier architecture](https://docs.fly.io/blueprints/n-tier-architecture.md)
* [Shared Nothing Architecture](https://docs.fly.io/blueprints/shared-nothing.md)
* [Sticky sessions (session affinity)](https://docs.fly.io/blueprints/sticky-sessions.md)
* [Multi-region databases with read replicas and fly-replay](https://docs.fly.io/blueprints/multi-region-fly-replay.md)

## Deployment & Developer Workflow

Stuff you set up once and adjust when you ship code. Includes previews, base images, staging, and Docker wrangling.

* [Working with Docker on Fly.io](https://docs.fly.io/blueprints/working-with-docker.md)
* [Custom deploy workflows: staggered and selective deploys](https://docs.fly.io/blueprints/custom-deploy-workflows.md)
* [Zero-downtime deployments](https://docs.fly.io/blueprints/seamless-deployments.md)
* [Roll back a deploy](https://docs.fly.io/blueprints/rollback-guide.md)
* [Git Branch Preview Environments on Github](https://docs.fly.io/blueprints/review-apps-guide.md)
* [Separate staging and production environments](https://docs.fly.io/blueprints/staging-prod-isolation.md)
* [Per-User Dev Environments with Fly Machines](https://docs.fly.io/blueprints/per-user-dev-environments.md)
* [Use Docker base images for faster deploys](https://docs.fly.io/blueprints/using-base-images-for-faster-deployments.md)
* [Managing Docker Images with Fly.io's Private Registry](https://docs.fly.io/blueprints/using-the-fly-docker-registry.md)

## Networking & Connectivity

Connecting things. Public apps, private services, bridging deployments, SSH, and WireGuard.

* [Run private apps with Flycast](https://docs.fly.io/blueprints/private-applications-flycast.md)
* [Connect to your private network with WireGuard](https://docs.fly.io/blueprints/connect-private-network-wireguard.md)
* [Connect AWS and other clouds with WireGuard](https://docs.fly.io/blueprints/bridge-deployments-wireguard.md)
* [Route requests to per-user Fly Machines](https://docs.fly.io/blueprints/connecting-to-user-machines.md)
* [Run an SSH server on a Fly Machine](https://docs.fly.io/blueprints/opensshd.md)

## Scaling, Performance & Observability

Make it fast. Make it reliable. Monitor what's happening.

* [Stream logs from user apps with NATS](https://docs.fly.io/blueprints/observability-for-user-apps.md)
* [Autoscale Fly Machines with autostop or fly-autoscaler](https://docs.fly.io/blueprints/autoscale-machines.md)
* [Autostart and autostop private apps with Flycast](https://docs.fly.io/blueprints/autostart-internal-apps.md)
* [Setting Hard and Soft Concurrency Limits](https://docs.fly.io/blueprints/setting-concurrency-limits.md)
* [Using Fly Volume forks for faster startup times](https://docs.fly.io/blueprints/volume-forking.md)
* [Run HIPAA-compliant healthcare apps](https://docs.fly.io/blueprints/going-to-production-with-healthcare-apps.md)

## Background Jobs & Automation

How to run periodic tasks, long-running jobs, infrastructure automation, and the things that run when you’re asleep.

* [Long-running tasks and machine lifecycle](https://docs.fly.io/blueprints/long-running-tasks.md) NEW!!
* [Building Infrastructure Automation without Terraform](https://docs.fly.io/blueprints/infra-automation-without-terraform.md)
* [Background job queues with Celery, BullMQ, and Fly Machines](https://docs.fly.io/blueprints/work-queues.md)
* [Task scheduling guide with Cron Manager and friends](https://docs.fly.io/blueprints/task-scheduling.md)
* [Crontab with Supercronic](https://docs.fly.io/blueprints/supercronic.md)