Deployments #

Hoist uses Docker containers for application deployments.

How Deployments Work #

1. Upload - Your code is uploaded to Hoist
2. Build - Docker image is built from your code
3. Deploy - Container is started with your image
4. Route - Proxy routes traffic to your container

Dockerfile #

Hoist looks for a Dockerfile in your project root:

FROM oven/bun:1

WORKDIR /app
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

COPY . .

EXPOSE 3000
CMD ["bun", "run", "start"]

Auto-Detection #

If no Dockerfile exists, Hoist auto-detects your framework:

Environment Variables #

Env vars are injected at runtime:

# Set before deploy
hoist env set --app my-app NODE_ENV=production
hoist env set --app my-app DATABASE_URL=postgres://...

# Then deploy
hoist deploy

Health Checks #

Hoist checks /health endpoint to verify deployment success:

app.get("/health", (req, res) => {
  res.json({ status: "ok" })
})

Rollbacks #

Instantly rollback to any previous deployment:

# List deployments
hoist deployments list --app my-app

# Rollback to specific version
hoist rollback <deployment-id>

Deployment Status #