Introduction to Ploy
Ploy is an open-source, self-hostable serverless deployment platform. Deploy from GitHub or Ploy Git, run serverless workers with databases, queues, and durable workflows, and host it all on your own infrastructure.
Ploy is an open serverless cloud. Connect a GitHub repository, or push to a Ploy Git repository with no GitHub account, and every push builds and deploys automatically, with a preview URL for each branch. Your code runs as serverless workers that get SQLite databases, message queues, durable workflows, cron triggers, an AI gateway, managed user auth, and sandboxes out of the box — with no servers to manage and nothing running when there is no traffic. The whole platform is open source and self-hostable.
How it works
- Choose a source — connect GitHub, or create a Ploy Git repository and push to it.
- Describe the project — a
ploy.yamlin your repository sets the build command and declares the bindings your code needs: databases, queues, workflows, cron triggers, AI, auth, and more. - Push — every push builds and deploys. The production branch goes live; every other branch gets its own preview URL.
- Run — your code runs as a worker with the declared bindings on
env. Run the same thing locally withploy dev. - Operate — follow build logs and deployment status in the dashboard, set environment variables, and roll back to any previous deployment in one step.
Products
Each product has its own section in the sidebar with an overview, ploy.yaml configuration, and the runtime API.
Platform
Push-to-deploy from GitHub or Ploy Git, preview deployments per branch, ploy.yaml, and environment variables.
Workers
Serverless functions with fast cold starts, plus cron triggers, timers, state, cache, and file storage.
Databases
SQLite databases attached to your workers with automatic migrations and Drizzle ORM support.
Queues
Durable message queues with at-least-once delivery for background processing.
Workflows
Durable, multi-step processes with persisted steps and automatic retries.
AI
Call OpenAI-compatible models from your workers through the built-in AI gateway.
Authentication
Managed user auth with email/password, sessions, and React components.
Sandboxes
Run commands, manage files, and execute code in isolated, long-lived environments.
Get started
Pick the framework you are building with. Each guide covers installation, ploy.yaml, local development, and how to use Ploy bindings from that framework.
CLI
Develop locally with ploy dev, generate types, and build your project.
Ploy Start
Build type-safe workers with Zod validation, Drizzle ORM, and generated OpenAPI docs.
Next.js
Use databases, queues, and workflows from Next.js server components and actions.
Vite
Deploy Vite apps, including TanStack Start, with the ploy() plugin.
TanStack Start
Run TanStack Start apps with server routes and prerendering on Ploy.
Self-Host
Run the whole platform on your own infrastructure with Docker.
AI tooling
Ploy is built to be read and driven by AI agents as well as people.
llms.txt
Machine-readable index of every documentation page, for LLM consumption.
llms-full.txt
The complete documentation in a single file for full-context ingestion.
AI Skills
Packaged instructions that teach AI coding agents how to build Ploy applications.
Agent SDK
Build and deploy AI agents with tools, hooks, durable state, and workflows.
Hosted or self-hosted
Ploy runs the same either way. Use the hosted platform at meetploy.com to skip setup entirely, or self-host it so your code, environment variables, and databases never leave your own infrastructure.
Related
CLI
Develop locally with ploy dev, generate types with ploy types, and push with ploy push.
Configuration
Every ploy.yaml option: build settings, bindings, assets, and deploy rules.
Self-Hosting Quickstart
Get your own Ploy instance running in minutes with Docker.
AI Skills
Packaged instructions that teach AI coding agents how to build on Ploy.
How is this guide?
Last updated on