Web Services

Available

A Web Service is a long-running container — your API, full-stack app, worker behind HTTP, anything that needs a process and CPU/RAM. Optionally attach a persistent disk that survives restarts.

Each service gets a free *.runsite.app subdomain and can serve any custom domain you attach.

Pricing & plans

Comparing options or looking for the free tier? See plans, specs and pricing on the Web Services hosting page.

How it works

Runsite always runs your app as an isolated Docker container. You ship one in two ways:

• From a Git repo — push your code, we build the image. We use your Dockerfile if there is one, otherwise we auto-detect the stack (Node, Python, Go, Java today).
• From a registry image — point at any public or private Docker image.

Supported Git providers: GitHub, GitLab, Bitbucket.

For the full platform model — deployment lifecycle, deploy states, ephemeral filesystem, health checks — see Runtime.

Dockerfile examples

Most stacks need only a few lines. Pick your runtime — Minimal gets you to a first deploy, Production is a multi-stage build with smaller images and faster cold starts.

Node

Minimal

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 8080
CMD ["node", "server.js"]

Production

FROM node:20-alpine AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci

FROM node:20-alpine AS build
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build && npm prune --omit=dev

FROM node:20-alpine
WORKDIR /app
ENV NODE_ENV=production
COPY --from=build /app/node_modules ./node_modules
COPY --from=build /app/dist ./dist
COPY --from=build /app/package*.json ./
EXPOSE 8080
CMD ["node", "dist/server.js"]

Python

Minimal

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8080
CMD ["gunicorn", "-b", "0.0.0.0:8080", "app:app"]

Production

FROM python:3.12-slim AS build
WORKDIR /app
ENV PIP_NO_CACHE_DIR=1 PIP_DISABLE_PIP_VERSION_CHECK=1
COPY requirements.txt .
RUN pip install --user -r requirements.txt

FROM python:3.12-slim
WORKDIR /app
ENV PATH=/root/.local/bin:$PATH \
    PYTHONDONTWRITEBYTECODE=1 \
    PYTHONUNBUFFERED=1
COPY --from=build /root/.local /root/.local
COPY . .
EXPOSE 8080
CMD ["gunicorn", "-b", "0.0.0.0:8080", "-w", "2", "app:app"]

Go

Minimal

FROM golang:1.23-alpine
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o server ./...
EXPOSE 8080
CMD ["./server"]

Production

FROM golang:1.23-alpine AS build
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -ldflags="-s -w" -o /server ./...

FROM gcr.io/distroless/static-debian12
COPY --from=build /server /server
EXPOSE 8080
USER nonroot:nonroot
CMD ["/server"]

The default port is 8080. If your app listens elsewhere, change it in Settings → Build & Deploy.

Don’t have a Dockerfile and your stack is one of Node, Python, Go or Java? Push without one — Runsite will detect the project and build it for you.

Where to next

• Runtime — container model, lifecycle, states, storage, health checks.
• Deploying — auto-deploy from Git and manual actions.
• Dashboard — what every tab does.
• Domains — default subdomain and custom domains.
• Scaling & resources — CPU, RAM, disk, autoscaling, sleep.

Front-end only?

If your project is a static site (React SPA, Astro, Hugo, plain HTML), use Static Sites instead — simpler, served from the edge, always-on.