Documentation

Build, deploy, and operate on Deploy Hatch.

Guides for GitHub source, deployments, configuration, domains, workflows, runtime operations, and troubleshooting.

Getting started

Quickstart

Deploy your first project end to end.

Deploy from GitHub

Connect source and create a deployment.

Create a project

Configure a new Deploy Hatch project.

Connect a repository

Authorize and select GitHub source.

Languages & workloads

Deploy Node.js

Deploy a Node.js application.

Deploy Python

Deploy supported Python workloads.

Deploy a Discord bot

Run a persistent Discord bot.

Background workers

Run long-lived non-web processes.

Deployments

How deployments work

From revision to managed runtime.

Deployment statuses

Understand lifecycle states.

Deployment logs

Diagnose builds and runtime output.

Redeployments

Rebuild and replace a workload.

Cancel a deployment

Intentionally cancel eligible work.

Rollbacks

Return to an earlier deployment revision.

Configuration

Environment variables

Manage runtime configuration and secrets.

Environments

Production, staging, and preview configuration.

Build & start commands

Control application build and startup.

CPU & memory limits

Configure container resources.

Domains & networking

Deployment URLs

Use managed application URLs.

Custom domains

Attach your own hostname.

DNS & verification

Verify and route custom domains.

Workflows

Automatic deployments

Deploy from Git activity.

Production & staging branches

Choose workflow branches.

Preview deployments

Configure pull-request previews.

Build cache

Control build caching.

Runtime

Start, restart & stop

Operate the current runtime intentionally.

Runtime health

Interpret workload health.

Automatic recovery

Understand bounded runtime recovery.

Crash loops

Diagnose repeated runtime failure.

AI agents

Connect your AI

Connect Copilot, Claude, or another compatible MCP client.

GitHub Copilot

Build and deploy from VS Code with Deploy Hatch MCP.

Claude

Connect Claude Code to Deploy Hatch over MCP.

Build and deploy with ChatGPT

The human quickstart for AI-built apps.

AI agents

Deploy through the public machine contract.

Agent quickstart

Connect an external coding agent or orchestrator.

Agent API & machine contract

Discover endpoints, scopes, schemas, and invariants.

Agent diagnosis & recovery

Follow machine-readable bounded recovery safely.

Account & help

Plans & limits

Understand account resource allowances.

Troubleshooting

Diagnose common deployment failures.