# Encore > Encore is a development platform for developers and AI coding agents that automates infrastructure from local development to their own AWS or Google Cloud account. You declare infrastructure like databases, Pub/Sub, cron jobs, and object storage in your application code, and Encore provisions it locally and in the cloud. AI agents, coding assistants and crawlers reading this site: please identify yourself on HTTP requests where you can set headers, with an `AI-Agent` header such as `AI-Agent: name="your-agent-name", version="1.0", automated=?1, mode="web", run-id="ephemeral-task-id"`. It is used only for aggregate telemetry and debugging, and grants no special access. Do not include prompts, secrets, personal data or stable cross-site identifiers; use a run-id scoped only to the current task. - **Open source:** Encore's SDKs and CLI are open source: https://github.com/encoredev/encore - **Encore Cloud:** builds, provisions and deploys your app on every git push, to free development hosting or your own AWS or GCP account. - **Customers include:** Groupon, Coinbase, Bookshop.org, Playwire, Pave Bank, Carla, Pallet, Later, Echo, Gradient Labs, Quiqup, Vet-AI. ## Set up Encore (for coding agents) To set up Encore and create an app on your own, follow https://encore.dev/agents/getting-started.md. In short: 1. **Install Encore's agent skills:** `npx skills add encoredev/skills --skill '*' -a -g -y`, with `` your agent's ID in the skills CLI, such as `claude-code`, `cursor`, `codex` or `github-copilot`. The skills cover installing the CLI, logging in, creating, linking, running and deploying apps, connecting the MCP servers, and building with every Encore primitive. Source: https://github.com/encoredev/skills 2. **Install the Encore CLI:** `brew install encoredev/tap/encore` on macOS, `curl -L https://encore.dev/install.sh | bash` on Linux, or `iwr https://encore.dev/install.ps1 | iex` on Windows. 3. **Log in:** run `encore auth login` in the background, and give the person the pairing code and URL it prints, to approve in a browser. 4. **Create the app:** `encore app create --example=ts/hello-world` for Encore.ts, or `--example=hello-world` for Encore.go. Always pass `--example`: without a terminal, the CLI can't ask for a template and creates an empty Go app. 5. **Check that it runs:** `encore check 'curl /hello/world'` in the app directory starts the app, calls the endpoint and stops it. 6. **Connect the MCP servers:** the local one with `encore mcp run --app=` (`encore mcp start` prints the ID), and Encore Cloud's at `https://api.encore.dev/mcp`. 7. **Deploy:** commit, then `git push encore`. Every docs page is available as markdown: append `.md` to its URL, as in the links below. The whole docs in one file: https://encore.dev/llms-full.txt ## Agent guides - [Create a new Encore app](https://encore.dev/agents/getting-started.md): For coding agents: install Encore's skills and the CLI, log in, create the app, verify it runs, connect the MCP servers, and deploy it with `git push encore`. - [Migrate an existing backend to Encore](https://encore.dev/agents/migrate.md): For coding agents: inspect the repository, identify its dependencies and infrastructure, agree on a plan, then migrate and verify one part at a time, with progress tracked in the repository. ## Start here - [Quickstart Guide](https://encore.dev/docs/quick-start.md): Build and deploy a backend with Encore. Create a REST API with PostgreSQL, run it locally, inspect traces, and deploy it to the cloud in a few minutes. - [AI-assisted development](https://encore.dev/docs/ai-integration.md): Set up coding agents with Encore skills, rules, and MCP context, with type-safe APIs and infrastructure guardrails. - [Deploying Applications with Encore](https://encore.dev/docs/platform/deploy/deploying.md): Learn how to deploy your backend application built with Encore with a single command, while Encore manages your entire CI/CD process. - [Fixing a failed deploy](https://encore.dev/docs/platform/deploy/troubleshooting.md): Common reasons an Encore deploy fails or doesn't start, with the error you'll see and how to fix it. - [CLI Reference](https://encore.dev/docs/cli/cli-reference.md): The Encore CLI lets you run your local development environment, create apps, and much more. See all CLI commands in this reference guide. ## Website - [Encore](https://encore.dev): Encore runs your app with real infrastructure locally, then automatically provisions and deploys it to your own AWS or GCP. - [Encore.ts](https://encore.dev/ts): An open-source infrastructure SDK for TypeScript. Declare databases, queues, and APIs in code, and Encore provisions them on your AWS or GCP. - [Encore.go](https://encore.dev/go): An open-source infrastructure SDK for Go. Declare databases, queues, and type-safe APIs in code, and Encore provisions them on your AWS or GCP. - [Encore.rs](https://encore.dev/rs): Rust infrastructure SDK. Declare databases, Pub/Sub, object storage, caches, cron jobs, and secrets in Rust, and Encore provisions them locally and in your own AWS or GCP account. - [Encore.py](https://encore.dev/py): Python infrastructure SDK. Declare databases, Pub/Sub, object storage, caches, cron jobs, and secrets in Python, and Encore provisions them locally and in your own AWS or GCP account. - [Features](https://encore.dev/product): Everything Encore does for your backend: automatic infrastructure, distributed tracing, preview environments, service catalog, IAM, secrets, CI/CD and more. - [Pricing](https://encore.dev/pricing): Starter (free), Pro, and Enterprise plans for Encore Cloud. - [Customer stories](https://encore.dev/customers): How companies use Encore to boost developer productivity, reduce DevOps workload, and cut infrastructure and staffing costs. - [Templates](https://encore.dev/templates): Starter apps to create with `encore app create --example`, or deploy from the Cloud Dashboard. - [Blog](https://encore.dev/blog): Encore's engineering blog, on the challenges of designing and building modern distributed systems. - [Comparisons](https://encore.dev/comparison): Encore compared to other backend platforms, including Fly.io, Railway, Render, Heroku, Supabase, Convex, Vercel, Pulumi, SST, and AWS CDK. - [About](https://encore.dev/about): The company behind Encore, founded by ex-Spotify and ex-Google engineers in Stockholm. ## Docs: Getting started - [What is Encore?](https://encore.dev/docs.md): Build apps with Encore’s open source SDK and CLI. Run services and infrastructure locally, then deploy to your own AWS or Google Cloud account. - [Quickstart Guide](https://encore.dev/docs/quick-start.md): Build and deploy a backend with Encore. Create a REST API with PostgreSQL, run it locally, inspect traces, and deploy it to the cloud in a few minutes. - [Understanding Encore](https://encore.dev/docs/understanding-encore.md): Learn how Encore connects application code, infrastructure, local development, and cloud deployment through one application model. - [AI-assisted development](https://encore.dev/docs/ai-integration.md): Set up coding agents with Encore skills, rules, and MCP context, with type-safe APIs and infrastructure guardrails. - [Building an Uptime Monitor](https://encore.dev/docs/tutorials/uptime.md): Learn how to build an event-driven uptime monitoring tool in TypeScript or Go with Encore. Get your application running in the cloud in 30 minutes! - [Building a Slack bot](https://encore.dev/docs/tutorials/slack-bot.md): Learn how to build a Slack bot with an Encore backend in TypeScript or Go, and get it running in the cloud in just a few minutes. - [Frequently Asked Questions](https://encore.dev/docs/faq.md): High-level answers about Encore's open source SDKs, managed platform, supported languages, infrastructure, deployment, and adoption. ## Docs: Building - [Test Statistics](https://encore.dev/docs/platform/test-statistics.md): See every test result from every build in Encore Cloud. Find failing and flaky tests, see where the time in your test suite goes, and catch the commit that made a test slower. - [Test Coverage](https://encore.dev/docs/platform/test-coverage.md): See which lines of your backend your tests run, in every build. Find untested files, see how coverage changes over time, and check that the code each commit changes is tested. - [App Structure](https://encore.dev/docs/app-structure.md): Learn how to structure monolith and microservices backends with Encore, including service boundaries, project layouts, data ownership, and communication. - [Mono vs Multi Repo](https://encore.dev/docs/mono-vs-multi-repo.md): Learn how to structure your application, using a Monorepo or a Multi-repo approach. - [Local Development Dashboard](https://encore.dev/docs/dev-dash.md): Encore's Local Development Dashboard comes with build-in distributed tracing, API docs, and real-time architecture diagrams. - [Running Scripts](https://encore.dev/docs/running-scripts.md): Learn how to use the `encore exec` command to run scripts like database seeding in your Encore app. - [Infrastructure Namespaces](https://encore.dev/docs/infra-namespaces.md): Learn how Encore's infrastructure namespaces makes it easy to task switch. Stash your infrastructure state and switch to a different task with a single command. - [Encore Toolbar](https://encore.dev/docs/encore-toolbar.md): Learn how to add the Encore Toolbar to your frontend to inspect API requests, link to distributed traces, and view backend logs during development. - [Local MCP Server](https://encore.dev/docs/mcp.md): Encore's Local Model Context Protocol (MCP) server provides deep introspection of your application to AI development tools. - [CORS](https://encore.dev/docs/cors.md): See how you can configure CORS for your Encore application. - [PostgreSQL Extensions](https://encore.dev/docs/postgres-extensions.md): See the list of pre-installed PostgreSQL extensions available when using Encore - [Environment Variables](https://encore.dev/docs/env-vars.md): Learn how to configure Encore's development environment using environment variables. ## Docs: Building (Encore.ts) - [Encore.ts](https://encore.dev/docs/ts.md): Encore.ts is an open source infrastructure SDK that lets you declare cloud infrastructure, such as databases, Pub/Sub, and object storage, directly in your TypeScript code. Covers the infrastructure primitives, services and APIs, and the path to production. - [Defining Services](https://encore.dev/docs/ts/primitives/services.md): Learn how to create microservices and define APIs for your cloud backend application using TypeScript and Encore. The easiest way of building cloud backends. - [Using SQL databases](https://encore.dev/docs/ts/primitives/databases.md): Learn how to use SQL databases for your backend application. See how to provision, migrate, and query PostgreSQL databases using Go and Encore. - [Using ORMs and Migration Frameworks with Encore.ts](https://encore.dev/docs/ts/develop/orms.md): Learn how to use ORMs with Encore.ts to seamlessly interact with SQL databases from your TypeScript / Node.js backend. - [Using Knex.js with Encore](https://encore.dev/docs/ts/develop/orms/knex.md): Learn how to use Knex.js with Encore to interact with SQL databases. - [Using Prisma with Encore.ts](https://encore.dev/docs/ts/develop/orms/prisma.md): Learn how to use Prisma with Encore to interact with SQL databases. - [Using Drizzle ORM with Encore](https://encore.dev/docs/ts/develop/orms/drizzle.md): Learn how to use Drizzle with Encore to interact with SQL databases. - [Using Sequelize with Encore.ts](https://encore.dev/docs/ts/develop/orms/sequelize.md): Learn how to use Sequelize with Encore to interact with SQL databases. - [Object Storage](https://encore.dev/docs/ts/primitives/object-storage.md): Learn how you can use Object Storage to store files and unstructured data in your backend application. - [Pub/Sub](https://encore.dev/docs/ts/primitives/pubsub.md): Learn how you can use PubSub as an asynchronous message queue in your backend application, a great approach for decoupling services for better reliability. - [Cron Jobs](https://encore.dev/docs/ts/primitives/cron-jobs.md): Learn how to create periodic and recurring tasks in your backend application using Encore's Cron Jobs API. - [Caching](https://encore.dev/docs/ts/primitives/caching.md): Learn how to implement caches to optimize response times and reduce cost in your TypeScript microservices cloud backend. - [Storing Secrets and API keys](https://encore.dev/docs/ts/primitives/secrets.md): Learn how to store API keys, and secrets, securely for your backend application. Encore's built in vault makes it simple to keep your app secure. - [Metadata](https://encore.dev/docs/ts/develop/metadata.md): See how to use Encore's Metadata API to get information about the app and the environment it's running in. - [Automated testing](https://encore.dev/docs/ts/develop/testing.md): Learn how create automated tests for your microservices backend application, and run them automatically on deploy using Go and Encore. - [Debugging](https://encore.dev/docs/ts/develop/debug.md): Learn how to debug your Encore.ts backend application from your IDE. - [Logging](https://encore.dev/docs/ts/observability/logging.md): Learn how to use structured logging, a combination of free-form log messages and type-safe key-value pairs, to understand your backend application's behavior. - [Metrics](https://encore.dev/docs/ts/observability/metrics.md): Learn how to define and use custom metrics in your TypeScript backend application with Encore. - [Multithreading](https://encore.dev/docs/ts/develop/multithreading.md): See how Encore.ts provides true multithreading for JavaScript applications, and how to enable Worker Pooling for CPU-intensive workloads. - [Defining Type-Safe APIs](https://encore.dev/docs/ts/primitives/defining-apis.md): Learn how to create APIs for your cloud backend application using TypeScript and Encore.ts - [API Calls](https://encore.dev/docs/ts/primitives/api-calls.md): Learn how to make type-safe API calls in TypeScript with Encore.ts - [Defining Raw Endpoints](https://encore.dev/docs/ts/primitives/raw-endpoints.md): Learn how to create raw API endpoints for your cloud backend application using TypeScript and Encore.ts - [API Errors](https://encore.dev/docs/ts/primitives/errors.md): See how to return structured error information from your APIs using Encore's errs package, and how to build precise error messages for complex business logic. - [Validation](https://encore.dev/docs/ts/primitives/validation.md): Learn how to validation incoming requests with Encore.ts - [Streaming APIs](https://encore.dev/docs/ts/primitives/streaming-apis.md): Learn how to create services that stream data. - [GraphQL](https://encore.dev/docs/ts/primitives/graphql.md): Learn how to create a GraphQL API for your cloud backend application using TypeScript and Encore.ts - [Static Assets](https://encore.dev/docs/ts/primitives/static-assets.md): Learn how to serve static assets with Encore.ts - [Working with Cookies](https://encore.dev/docs/ts/primitives/cookies.md): Learn how to work with cookies in your TypeScript backend applications built with Encore.ts - [Types](https://encore.dev/docs/ts/primitives/types.md): Learn how to work with types in Encore.ts schemas - [Handling file uploads](https://encore.dev/docs/ts/how-to/file-uploads.md): Learn how to store file uploads as bytes in a database and serving them back to the client. - [Authenticating users](https://encore.dev/docs/ts/develop/auth.md): Learn how to add authentication to your APIs and make sure you know who's calling your backend APIs. - [Middleware](https://encore.dev/docs/ts/develop/middleware.md): See how you can use middleware in your Encore.ts application to handle cross-cutting generic functionality, like request logging, auth, or tracing. - [API Documentation](https://encore.dev/docs/ts/develop/api-docs.md): Learn how to write doc comments in your Encore.ts app that appear in the Service Catalog, generated clients, and OpenAPI specs. - [Client Library Generation](https://encore.dev/docs/ts/cli/client-generation.md): Learn how you can use automatic API client generation to get clients for your backend. See how to integrate with your frontend using a type-safe generated client. - [Request client for the frontend](https://encore.dev/docs/ts/frontend/request-client.md): Learn how to use Encore's built-in client generation to get type-safety between your backend and frontend. - [Building a REST API](https://encore.dev/docs/ts/tutorials/rest-api.md): Learn how to build and ship a REST API in just a few minutes using Encore.ts, go from zero to running API with this tutorial. - [Building a GraphQL API](https://encore.dev/docs/ts/tutorials/graphql.md): Learn how to build a microservices backend in TypeScript, powered by GraphQL and Encore.ts - [Hosting a frontend](https://encore.dev/docs/ts/frontend/hosting.md): Learn how to host your frontend when having a Encore.ts backend application. - [Use a template engine](https://encore.dev/docs/ts/frontend/template-engine.md): Learn how to use a template engine to create server-rendered HTML with dynamic data. - [encore.dev](https://encore.dev/docs/ts/runtime/encore-dev.md) - [encore.dev/api](https://encore.dev/docs/ts/runtime/api.md) - [encore.dev/auth](https://encore.dev/docs/ts/runtime/auth.md) - [encore.dev/config](https://encore.dev/docs/ts/runtime/config.md) - [encore.dev/cron](https://encore.dev/docs/ts/runtime/cron.md) - [encore.dev/log](https://encore.dev/docs/ts/runtime/log.md) - [encore.dev/metrics](https://encore.dev/docs/ts/runtime/metrics.md) - [encore.dev/pubsub](https://encore.dev/docs/ts/runtime/pubsub.md) - [encore.dev/service](https://encore.dev/docs/ts/runtime/service.md) - [encore.dev/storage/cache](https://encore.dev/docs/ts/runtime/storage-cache.md) - [encore.dev/storage/objects](https://encore.dev/docs/ts/runtime/storage-objects.md) - [encore.dev/storage/sqldb](https://encore.dev/docs/ts/runtime/storage-sqldb.md) - [encore.dev/types](https://encore.dev/docs/ts/runtime/types.md) - [encore.dev/validate](https://encore.dev/docs/ts/runtime/validate.md) - [Turborepo](https://encore.dev/docs/ts/develop/monorepo/turborepo.md): Learn how to set up Encore.ts in a Turborepo monorepo with shared packages that require building before use. - [Nx](https://encore.dev/docs/ts/develop/monorepo/nx.md): Learn how to set up Encore.ts in an Nx monorepo with shared packages that require building before use. ## Docs: Building (Encore.go) - [Encore.go](https://encore.dev/docs/go.md): Encore.go is an open source infrastructure SDK that lets you declare cloud infrastructure, such as databases, Pub/Sub, and object storage, directly in your Go code. Covers the infrastructure primitives, services and APIs, and the path to production. - [Defining Services](https://encore.dev/docs/go/primitives/services.md): Learn how to create microservices and define APIs for your cloud backend application using Go and Encore. The easiest way of building cloud backends. - [Use Atlas + GORM for database migrations](https://encore.dev/docs/go/how-to/atlas-gorm.md): See how you can use Atlas to manage your database migrations in your Encore application. - [Use ent ORM + Atlas for database schemas](https://encore.dev/docs/go/how-to/entgo-orm.md): See how you can use an ORM like ent with Atlas to handle your database schemas. - [Change SQL database schema](https://encore.dev/docs/go/primitives/change-db-schema.md): Learn how to change your SQL database schema for your Go backend application, using migration files and Encore's built-in schema migration functionality. - [Integrate with existing databases](https://encore.dev/docs/go/primitives/connect-existing-db.md): Learn how to integrate your Encore Go backend application with an existing database, in any cloud you choose. - [Insert test data in a database](https://encore.dev/docs/go/primitives/insert-test-data-db.md): Learn how to populate your database with test data using Go and Encore, making testing your backend application much simpler. - [Share SQL databases between services](https://encore.dev/docs/go/primitives/share-db-between-services.md): Learn how to share a SQL database between multiple Go backend services using Encore. - [Troubleshooting Databases](https://encore.dev/docs/go/primitives/databases/troubleshooting.md): Advice on troubleshooting SQL databases in Encore.go - [Using SQL databases](https://encore.dev/docs/go/primitives/databases.md): Learn how to use SQL databases for your backend application. See how to provision, migrate, and query PostgreSQL databases using Go and Encore. - [Object Storage](https://encore.dev/docs/go/primitives/object-storage.md): Learn how you can use Object Storage to store files and unstructured data in your backend application. - [Transactional Pub/Sub outbox](https://encore.dev/docs/go/how-to/pubsub-outbox.md): Learn how you can use a transactional outbox with Pub/Sub to guarantee consistency between your database and Pub/Sub subscribers - [Pub/Sub](https://encore.dev/docs/go/primitives/pubsub.md): Learn how you can use PubSub as an asynchronous message queue in your backend application, a great approach for decoupling services for better reliability. - [Cron Jobs](https://encore.dev/docs/go/primitives/cron-jobs.md): Learn how to create periodic and recurring tasks in your backend application using Encore's Cron Jobs API. - [Caching](https://encore.dev/docs/go/primitives/caching.md): Learn how to implement caches to optimize response times and reduce cost in your microservices cloud backend. - [Storing Secrets and API keys](https://encore.dev/docs/go/primitives/secrets.md): Learn how to store API keys, and secrets, securely for your backend application. Encore's built in vault makes it simple to keep your app secure. - [Metadata](https://encore.dev/docs/go/develop/metadata.md): See how to use Encore's Metadata API to get information about specific apps, environments, and requests. - [Mocking](https://encore.dev/docs/go/develop/testing/mocking.md): Learn how to mock out your APIs and services for testing, and how to use the built-in mocking support in Encore. - [Automated testing](https://encore.dev/docs/go/develop/testing.md): Learn how create automated tests for your microservices backend application, and run them automatically on deploy using Go and Encore. - [Debug with Delve](https://encore.dev/docs/go/how-to/debug.md): Learn how to debug your Encore.go backend application using Delve. - [Logging](https://encore.dev/docs/go/observability/logging.md): Learn how to use structured logging, a combination of free-form log messages and key-value pairs, to understand your backend application's behavior. - [Metrics](https://encore.dev/docs/go/observability/metrics.md): Learn how to define and use custom metrics in your Go backend application with Encore. - [Configuration](https://encore.dev/docs/go/develop/config.md): See how you can use configuration to define different behavior in each environment. Making it simpler to develop and test your backend application. - [Defining Type-Safe APIs](https://encore.dev/docs/go/primitives/defining-apis.md): Learn how to create APIs for your cloud backend application using Go and Encore.go - [API Calls](https://encore.dev/docs/go/primitives/api-calls.md): Learn how to make type-safe API calls in Go with Encore.go - [Raw Endpoints](https://encore.dev/docs/go/primitives/raw-endpoints.md): Learn how to create raw API endpoints for your cloud backend application using Go and Encore.go - [API Errors](https://encore.dev/docs/go/primitives/api-errors.md): See how to return structured error information from your APIs using Encore's errs package, and how to build precise error messages for complex business logic. - [Validation](https://encore.dev/docs/go/develop/validation.md): Learn how request validation works, and see how you can use Encore's built-in middleware to validate incoming requests in your backend application. - [Service structs](https://encore.dev/docs/go/primitives/service-structs.md): Learn how to use service structs to define APIs as methods. - [Dependency Injection](https://encore.dev/docs/go/how-to/dependency-injection.md): Learn how to use dependency injection in your Go based microservices backend application using Encore. - [Receive regular HTTP requests](https://encore.dev/docs/go/how-to/http-requests.md): Learn how to receive regular HTTP requests in your Go based backend application using Encore. - [Use Connect for incoming gRPC requests](https://encore.dev/docs/go/how-to/grpc-connect.md): See how you can use the Connect protocol for gRPC communication with Encore services - [Code snippets](https://encore.dev/docs/go/primitives/code-snippets.md): Learn how to build cloud-agnostic backend applications using Encore's Backend Framework. - [Authenticating users](https://encore.dev/docs/go/develop/auth.md): Learn how to add authentication to your APIs and make sure you know who's calling your backend APIs. - [Middleware](https://encore.dev/docs/go/develop/middleware.md): See how you can use middleware in your backend application to handle cross-cutting generic functionality, like request logging, auth, or tracing. - [Use Auth0 with your app](https://encore.dev/docs/go/how-to/auth0-auth.md): Learn how to use Auth0 for user authentication in your backend application. In this guide we show you how to integrate your Go backend with Auth0. - [Use Clerk with your app](https://encore.dev/docs/go/how-to/clerk-auth.md): Learn how to use Clerk for user authentication in your backend application. In this guide we show you how to integrate your Go backend with Clerk. - [Use Firebase Auth with your app](https://encore.dev/docs/go/how-to/firebase-auth.md): Learn how to use Firebase Auth for user authentication in your backend application. In this guide we show you how to integrate your Go backend with Firebase Auth. - [Use Logto with your app](https://encore.dev/docs/go/how-to/logto-auth.md): Learn how to use Logto for user authentication in your backend application. In this guide we show you how to integrate your Go backend with Logto. - [API Documentation](https://encore.dev/docs/go/develop/api-docs.md): Learn how to write doc comments in your Encore.go app that appear in the Service Catalog, generated clients, and OpenAPI specs. - [Client Library Generation](https://encore.dev/docs/go/cli/client-generation.md): Learn how you can use automatic API client generation to get clients for your backend. See how to integrate with your frontend using a type-safe generated client. - [Integrate with a web frontend](https://encore.dev/docs/go/how-to/integrate-frontend.md): Learn how to integrate your Go backend application with a frontend, using Encore's built-in frontend client generation feature. - [Building a REST API](https://encore.dev/docs/go/tutorials/rest-api.md): Learn how to build and ship a REST API in just a few minutes, Encore.go. Go from zero to running API with this tutorial. - [Building a GraphQL API](https://encore.dev/docs/go/tutorials/graphql.md): Learn how to build a microservices backend in Go, powered by GraphQL and Encore. - [Build with cgo](https://encore.dev/docs/go/how-to/cgo.md): Learn how to build Go applications with cgo using Encore ## Docs: Building (Encore.py) - [Encore.py](https://encore.dev/docs/py.md): Encore.py is an infrastructure SDK for Python. Declare databases, Pub/Sub, object storage, Redis, cron jobs and secrets in your Python code, and keep your own web framework, such as FastAPI or Django. - [Services](https://encore.dev/docs/py/primitives/services.md): Learn how to define services in a Python application with Encore, using encore.service.json, and how services find each other's URLs. - [Databases](https://encore.dev/docs/py/primitives/databases.md): Learn how to declare, migrate and query PostgreSQL databases in a Python application with Encore.py, including transactions, sharing databases between services, and using Django or other ORMs. - [Object Storage](https://encore.dev/docs/py/primitives/object-storage.md): Learn how to store files and unstructured data in buckets from your Python application using Encore.py. - [Pub/Sub](https://encore.dev/docs/py/primitives/pubsub.md): Learn how to use Pub/Sub topics and subscriptions as an asynchronous message queue in your Python application using Encore.py. - [Cron Jobs](https://encore.dev/docs/py/primitives/cron-jobs.md): Learn how to run periodic and scheduled tasks in your Python backend application using Encore.py's cron jobs. - [Workers](https://encore.dev/docs/py/primitives/workers.md): Learn how to run background processes next to a Python service with Encore.py workers, for Pub/Sub consumers, Temporal workers and other long-running work that serves no requests. - [Redis](https://encore.dev/docs/py/primitives/redis.md): Learn how to declare Redis databases and use them for caching, counters, queues and more in your Python application using Encore.py. - [Secrets](https://encore.dev/docs/py/primitives/secrets.md): Learn how to declare secrets such as API keys in your Python backend with Encore.py, and how to give them values locally and in the cloud. - [Metadata](https://encore.dev/docs/py/develop/metadata.md): See how to use Encore.py's metadata API to get information about the running application, its environment, build and deployment. - [Testing](https://encore.dev/docs/py/develop/testing.md): Learn how to test a Python application built with Encore.py using pytest and encore test, with isolated databases, buckets, Pub/Sub topics and Redis for every test run. - [Logging](https://encore.dev/docs/py/observability/logging.md): Learn how to use Python's standard logging module with Encore.py to write structured logs that carry trace and span IDs. - [Metrics](https://encore.dev/docs/py/observability/metrics.md): Learn how to define and record custom metrics in your Python backend with Encore.py, using counters, gauges and histograms built on OpenTelemetry. - [Tracing](https://encore.dev/docs/py/observability/tracing.md): Learn how Encore.py traces your Python app's infrastructure calls, and how to add your web framework's requests and your own spans with OpenTelemetry. - [Configuration](https://encore.dev/docs/py/develop/config.md): Learn how to declare typed configuration in your Python backend with Encore.py, write its values in TOML or JSON, and vary them by environment. - [Graceful shutdown](https://encore.dev/docs/py/develop/shutdown.md): Learn how Encore.py shuts down a Python service gracefully, draining Pub/Sub, closing connections and flushing telemetry, and how to coordinate it with your own application. - [Policies](https://encore.dev/docs/py/develop/policies.md): Learn how to write policies for your Python backend with Encore, rules in CEL over your app's services, resources, domains and tags, and check your app against them. ## Docs: Building (Encore.rs) - [Encore.rs](https://encore.dev/docs/rs.md): Encore.rs is an infrastructure SDK for Rust. Declare databases, Pub/Sub, object storage, Redis, cron jobs and secrets as statics in your Rust code, and keep your own web framework. - [Services](https://encore.dev/docs/rs/primitives/services.md): How Rust services are declared with encore.service.json, how Encore builds, runs and tests them, how infrastructure is attributed to a service, and how services reach each other. - [Databases](https://encore.dev/docs/rs/primitives/databases.md): Declare PostgreSQL databases in Rust with Encore.rs, write migrations, query with a tokio-postgres style API, run transactions, share databases between services, and connect ORMs. - [Object Storage](https://encore.dev/docs/rs/primitives/object-storage.md): Learn how to store files and unstructured data in object storage buckets from a Rust application with Encore.rs. - [Pub/Sub](https://encore.dev/docs/rs/primitives/pubsub.md): Learn how to publish and subscribe to events with Pub/Sub topics from a Rust application with Encore.rs, to decouple services and build asynchronous systems. - [Cron Jobs](https://encore.dev/docs/rs/primitives/cron-jobs.md): Learn how to run periodic and scheduled tasks in your Rust backend application with Encore.rs cron jobs. - [Workers](https://encore.dev/docs/rs/primitives/workers.md): Learn how to run background processes next to a Rust service with Encore.rs workers, for Pub/Sub consumers, Temporal workers and other long-running work that serves no requests. - [Redis](https://encore.dev/docs/rs/primitives/redis.md): Learn how to declare Redis databases and use them for caching, counters, queues and more from a Rust application with Encore.rs. - [Storing Secrets and API keys](https://encore.dev/docs/rs/primitives/secrets.md): Learn how to store API keys and other secrets securely in your Rust backend with Encore.rs, and use them in your code without putting them in source control. - [Metadata](https://encore.dev/docs/rs/develop/metadata.md): See how to use Encore.rs's metadata API to get information about the running application, its environment, build, and deployment. - [Testing](https://encore.dev/docs/rs/develop/testing.md): Run Rust tests with encore test, where every test gets its own databases, buckets, Redis databases and Pub/Sub topics. Covers - [Logging](https://encore.dev/docs/rs/observability/logging.md): Learn how to use structured logging in your Rust backend with Encore.rs and the log crate, with key-value fields and trace correlation. - [Metrics](https://encore.dev/docs/rs/observability/metrics.md): Learn how to define and use custom metrics in your Rust backend application with Encore.rs. - [Tracing](https://encore.dev/docs/rs/observability/tracing.md): Learn how Encore.rs traces your Rust app's infrastructure calls, and how to add your own request spans with tracing and OpenTelemetry. - [Configuration](https://encore.dev/docs/rs/develop/config.md): Learn how to define typed configuration in your Rust backend with Encore.rs, with values written in TOML or JSON and overridden per environment. - [Graceful shutdown](https://encore.dev/docs/rs/develop/shutdown.md): Learn how Encore.rs shuts down a Rust service gracefully, draining in-flight requests and Pub/Sub messages and flushing telemetry before the process exits. - [Policies](https://encore.dev/docs/rs/develop/policies.md): Learn how to write policies for your Rust backend with Encore, rules in CEL over your app's services, resources, domains and tags, and check your app against them. ## Docs: Deploying - [Encore Platform](https://encore.dev/docs/platform/introduction.md): The Encore platform is the managed platform that pairs with the Encore.ts and Encore.go infrastructure SDKs to provision and operate AWS and GCP from your code. - [Development Workflow](https://encore.dev/docs/platform/workflow.md): Follow an Encore change from resource declarations through local development, tests, preview environments, and production on AWS or GCP. - [AI Integration](https://encore.dev/docs/platform/ai-integration.md): Learn how the Encore platform enables AI agents to provision infrastructure in AWS/GCP with automatic guardrails, preview environments, and more. - [Cloud MCP Server](https://encore.dev/docs/platform/cloud-mcp.md): Connect AI agents to your deployed environments on Encore Cloud using the Model Context Protocol (MCP) server. - [Deploying Applications with Encore](https://encore.dev/docs/platform/deploy/deploying.md): Learn how to deploy your backend application built with Encore with a single command, while Encore manages your entire CI/CD process. - [Fixing a failed deploy](https://encore.dev/docs/platform/deploy/troubleshooting.md): Common reasons an Encore deploy fails or doesn't start, with the error you'll see and how to fix it. - [Connect your cloud account](https://encore.dev/docs/platform/deploy/own-cloud.md): Learn how to deploy your backend application to all the major cloud providers (AWS or GCP) using Encore. - [Creating & configuring environments](https://encore.dev/docs/platform/deploy/environments.md): Learn how to create all the environments you need for your backend application, local, preview, testing and production. Here's how you keep them in sync! - [Preview Environments](https://encore.dev/docs/platform/deploy/preview-environments.md): Learn how to use Encore to activate automatic Preview Environments for every Pull Request to simplify testing and collaborating. - [Private Packages](https://encore.dev/docs/platform/deploy/private-packages.md): Learn how to give Encore Cloud builds access to private npm scopes and Go modules, without committing tokens to your repository. - [Infrastructure provisioning & Environments](https://encore.dev/docs/platform/infrastructure/infra.md): Learn how to provision appropriate cloud infrastructure depending on the environment type for AWS and GCP. - [Infrastructure Configuration](https://encore.dev/docs/platform/infrastructure/configuration.md): Learn how you can configure infrastructure provisioned using the Encore platform - [Resource Tagging](https://encore.dev/docs/platform/infrastructure/tagging.md): Learn how Encore tags AWS and GCP infrastructure to identify applications, environments, resources, and associated services. - [Use Neon Postgres](https://encore.dev/docs/platform/infrastructure/neon.md): Learn how to configure your environment to provision a Neon Postgres database. - [Cloudflare R2 Buckets](https://encore.dev/docs/platform/infrastructure/cloudflare.md): A comprehensive guide to how the Encore platform provisions and manages Cloudflare R2 infrastructure for your applications - [GCP Infrastructure](https://encore.dev/docs/platform/infrastructure/gcp.md): A comprehensive guide to how the Encore platform provisions and manages GCP infrastructure for your applications - [Import an existing Cloud SQL instance](https://encore.dev/docs/platform/infrastructure/gcp/import-cloud-sql.md): Learn how to easily import your existing Cloud SQL instance and connect your Encore application to it. - [Import an existing Pub/Sub topic](https://encore.dev/docs/platform/infrastructure/gcp/import-pubsub-topic.md): Learn how to connect an existing GCP Pub/Sub topic to your Encore application in place of an Encore-provisioned one. - [Import an existing Cloud Storage bucket](https://encore.dev/docs/platform/infrastructure/gcp/import-gcs-bucket.md): Learn how to connect an existing GCP Cloud Storage bucket to your Encore application in place of an Encore-provisioned one. - [Import an existing GCP project](https://encore.dev/docs/platform/infrastructure/gcp/import-project.md): Learn how to easily import your existing GCP project and connect your Encore application to it. - [Configure network settings](https://encore.dev/docs/platform/infrastructure/configure-network.md): Learn how to configure IP ranges when connecting your Encore application to existing networks. - [Configure a static outbound IP](https://encore.dev/docs/platform/infrastructure/gcp/static-ip.md): Learn how to give your Encore application on GCP Cloud Run a stable outbound IP address using Cloud NAT and VPC egress. - [AWS Infrastructure](https://encore.dev/docs/platform/infrastructure/aws.md): A comprehensive guide to how the Encore platform provisions and manages AWS infrastructure for your applications - [Import an existing RDS or Aurora database](https://encore.dev/docs/platform/infrastructure/aws/import-rds.md): Learn how to import your existing Amazon RDS for PostgreSQL instance or Aurora PostgreSQL cluster and connect your Encore application to it. - [Import an existing SNS topic](https://encore.dev/docs/platform/infrastructure/aws/import-sns-topic.md): Learn how to connect an existing AWS SNS topic to your Encore application in place of an Encore-provisioned one. - [Import an existing S3 bucket](https://encore.dev/docs/platform/infrastructure/aws/import-s3-bucket.md): Learn how to connect an existing AWS S3 bucket to your Encore application in place of an Encore-provisioned one. - [Deploy to a new Kubernetes cluster](https://encore.dev/docs/platform/infrastructure/kubernetes.md): Learn how to automatically deploy your Encore application to a new Kubernetes cluster. - [Import an existing Kubernetes cluster](https://encore.dev/docs/platform/infrastructure/import-kubernetes-cluster.md): Learn how to easily import your existing Kubernetes cluster and deploy your Encore application into it. - [Configure kubectl](https://encore.dev/docs/platform/infrastructure/configure-kubectl.md): Learn how to configure kubectl to access your Encore Kubernetes cluster. - [Build Docker Images](https://encore.dev/docs/self-host/build.md): Learn how to build Docker images for your Encore application, which can be self-hosted on your own infrastructure. - [Configure Infrastructure](https://encore.dev/docs/self-host/configure-infra.md): Learn how to configure infrastructure resources for your Encore app. - [Integrate with your CI/CD pipeline](https://encore.dev/docs/self-host/ci-cd.md): Learn how to integrate Encore with your CI/CD pipeline. - [Deploy to DigitalOcean](https://encore.dev/docs/self-host/deploy-digitalocean.md): Learn how to deploy an Encore application to DigitalOcean's App Platform using Docker. - [Deploy to Railway](https://encore.dev/docs/self-host/deploy-railway.md): Learn how to deploy an Encore application to Railway using Docker and GitHub Actions. ## Docs: Observability - [Service Catalog](https://encore.dev/docs/service-catalog.md): See how Encore automatically generates API documentation that always stays up to date and in sync. - [Distributed Tracing](https://encore.dev/docs/tracing.md): See how to use distributed tracing in your backend application, across multiple services, using Encore. - [Architecture Diagram](https://encore.dev/docs/architecture.md): Visualize your microservices architecture automatically using Encore. Get real-time interactive architecture diagrams for your entire application. ## Docs: Operations - [Application Security](https://encore.dev/docs/platform/deploy/security.md): Encore applications come with built-in security best practises. See how Encore keeps your application secure by default. - [Trace Sampling & Budgets](https://encore.dev/docs/platform/observability/tracing.md): Control how many traces the Encore platform records and cap what tracing costs, with per-environment sampling rates and daily and monthly spend limits. - [Metrics Integrations](https://encore.dev/docs/platform/observability/metrics.md): Forward the metrics your Encore application exposes to third-party observability services from the Encore platform. - [Managing Infrastructure](https://encore.dev/docs/platform/infrastructure/managing-infrastructure.md): Learn how the Encore platform protects your infrastructure with deletion safeguards, handles upgrades, and supports disaster recovery for production environments. - [Just-in-time Access](https://encore.dev/docs/platform/infrastructure/jit-access.md): Learn how the Encore platform uses GCP Privileged Access Manager (PAM) to grant temporary, time-bound permissions during deploys instead of holding standing access. - [External Vaults](https://encore.dev/docs/platform/infrastructure/external-vaults.md): Learn how to connect external secret stores like GCP Secret Manager to the Encore platform and reference their secrets from your application at runtime. - [Managing database user credentials](https://encore.dev/docs/platform/infrastructure/manage-db-users.md): Learn how to manage user credentials for databases created by Encore. - [Integrate with GitHub](https://encore.dev/docs/platform/integrations/github.md): Learn how to integrate your backend application with GitHub to get automatic Preview Environments for each Pull Request using Encore. - [Custom Domains](https://encore.dev/docs/platform/integrations/custom-domains.md): Learn how to setup a custom domain for your cloud environments, to use your own domain to access your backend application built with Encore. - [Webhooks & Events](https://encore.dev/docs/platform/integrations/webhooks.md): The Encore platform lets you define webhooks to react to events in your application, enabling you to build powerful integrations. - [OAuth Clients](https://encore.dev/docs/platform/integrations/oauth-clients.md): Learn how to use OAuth Clients for access to the Encore platform API - [Generating Auth Keys](https://encore.dev/docs/platform/integrations/auth-keys.md): Learn how to use pre-authentication keys to authenticate without needing to sign in via a web browser. See how to setup reusable and ephemeral auth keys. - [Terraform Provider](https://encore.dev/docs/platform/integrations/terraform.md): The Encore Terraform Provider lets you integrate your Encore deployment with existing infrastructure ## Docs: Management & billing - [Security & Compliance](https://encore.dev/docs/platform/management/compliance.md): Learn about Encore's security practices, infrastructure protections, and compliance posture — built on industry-standard controls and trusted cloud providers. - [Plans & Billing](https://encore.dev/docs/platform/management/billing.md): Encore is free to use for many projects, and comes with paid plans for teams who want to move quickly. Learn more! - [Roles & Permissions](https://encore.dev/docs/platform/management/permissions.md): Encore helps your whole team build applications and collaborate across backend and frontend teams. - [Usage limits](https://encore.dev/docs/platform/management/usage.md): Encore comes with a built-in development cloud with generous Fair Use limits. This makes it easy to get started building your next backend application without requiring a cloud account. - [Telemetry](https://encore.dev/docs/platform/management/telemetry.md): Encore collects telemetry data about app usage ## Docs: Guides - [Migrating an existing system to Encore](https://encore.dev/docs/platform/migration/migrate-to-encore.md): Learn how to migrate your application to Encore incrementally, and unlock Encore's powerful set of development tools for your team. - [Coming from an IaC tool](https://encore.dev/docs/platform/migration/from-iac.md): Map existing Terraform, Pulumi, OpenTofu, or CDK workflows to Encore and plan an incremental migration. - [Coming from Terraform](https://encore.dev/docs/platform/migration/from-terraform.md): How Terraform resources map to Encore primitives, where each infrastructure setting is configured, and how to run Encore alongside existing Terraform. - [Coming from Pulumi](https://encore.dev/docs/platform/migration/from-pulumi.md): Map Pulumi projects, stacks, resources, configuration, and state to Encore, and migrate infrastructure incrementally. - [Coming from OpenTofu](https://encore.dev/docs/platform/migration/from-opentofu.md): Map OpenTofu resources, modules, workspaces, state, and imports to Encore, and migrate infrastructure incrementally. - [Coming from AWS CDK](https://encore.dev/docs/platform/migration/from-cdk.md): Map AWS CDK constructs, stacks, environments, CloudFormation resources, and imports to Encore, and migrate incrementally. - [Coming from a PaaS](https://encore.dev/docs/platform/migration/from-paas.md): How application hosting, managed databases, background work, platform services, and deployment workflows map from a PaaS to Encore. - [Coming from Supabase](https://encore.dev/docs/platform/migration/from-supabase.md): Migrate a Supabase backend to Encore, or keep Supabase services alongside an Encore application during an incremental migration. - [Coming from Firebase](https://encore.dev/docs/platform/migration/from-firebase.md): Migrate Firebase data, functions, authentication, and storage to Encore, or run both systems during an incremental migration. - [Coming from Railway](https://encore.dev/docs/platform/migration/from-railway.md): Migrate Railway services, databases, variables, volumes, and deployment workflows to Encore. - [Coming from Heroku](https://encore.dev/docs/platform/migration/from-heroku.md): Migrate Heroku dynos, Postgres, Key-Value Store, add-ons, config vars, and deployment workflows to Encore. - [Coming from Vercel](https://encore.dev/docs/platform/migration/from-vercel.md): Migrate Vercel backend functions, cron jobs, storage, environment variables, and domains to Encore. - [Coming from Fly.io](https://encore.dev/docs/platform/migration/from-flyio.md): Migrate Fly.io Machines, Postgres, volumes, secrets, networking, and deployment workflows to Encore. - [Migrate using AI agent](https://encore.dev/docs/ai-migration.md): Learn how to use Encore's AI migration skill to automatically migrate your existing backend to Encore, with validation at every step. - [Migrate away from Encore](https://encore.dev/docs/migrate-away.md): If you love someone, set them free. - [Break a monolith into microservices](https://encore.dev/docs/break-up-monolith.md): Learn how to quickly break up your backend monolith into microservices using Encore, while avoiding the common pitfalls. ## Docs: Guides (Encore.ts) - [Better Auth](https://encore.dev/docs/ts/develop/integrations/better-auth.md): Learn how to add production-ready authentication to your Encore.ts application using Better Auth, with automatic database provisioning and secrets management. - [Polar](https://encore.dev/docs/ts/develop/integrations/polar.md): Learn how to add payments, subscriptions, and license keys to your Encore.ts application using Polar as your Merchant of Record. - [Resend](https://encore.dev/docs/ts/develop/integrations/resend.md): Learn how to send transactional emails from your Encore.ts application using Resend, with async delivery via Pub/Sub and built-in observability. - [Migrating from Express.js](https://encore.dev/docs/ts/migration/express-migration.md): Learn how migrate your Express.js app over to use Encore.ts for better performance and improved development tools. - [Use NestJS with Encore](https://encore.dev/docs/ts/how-to/nestjs.md): Learn how to use NestJS to structure your business logic and Encore for creating infrastructure resources. ## Docs: Guides (Encore.go) - [Use Temporal with Encore](https://encore.dev/docs/go/how-to/temporal.md): Learn how to use Temporal for reliable workflow execution with Encore. ## Docs: Reference - [CLI Reference](https://encore.dev/docs/cli/cli-reference.md): The Encore CLI lets you run your local development environment, create apps, and much more. See all CLI commands in this reference guide. - [Configuration Reference](https://encore.dev/docs/cli/config-reference.md): Configuration options to customize the behavior of the Encore CLI. - [Encore Platform API Reference](https://encore.dev/docs/platform/integrations/api-reference.md): Learn how to use the Encore platform API. ## Docs: Community - [Community](https://encore.dev/docs/community/get-involved.md): Learn how to engage in the Open Source Developer Community supporting Encore. - [Ways to contribute](https://encore.dev/docs/community/contribute.md): Learn how to contribute to the Encore Open Source project by submitting pull requests, reporting bugs, or contributing documentation or example projects. - [Open Source](https://encore.dev/docs/community/open-source.md): We believe Open Source is key to a sustainable and prosperous technology community. Encore builds on Open Source software, and is itself Open Source. - [Community principles](https://encore.dev/docs/community/principles.md): Everyone is welcome in the Encore community, and we want everyone to feel at home and free to contribute. - [Submit a Template](https://encore.dev/docs/community/submit-template.md): Learn how to contribute to Encore's Templates repository and get features in the Encore Templates marketplace.