Docker Guide - Bedrud

Bedrud provides a multi-stage Dockerfile for building and running in containers.

Quick Start

# Build
docker build -t bedrud .
 
# Run
docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -p 50000-60000:50000-60000/udp \
  bedrud

Dockerfile Overview

The Dockerfile uses three stages to minimize the final image size:

Stage 1: Frontend Build

FROM node:22-alpine AS frontend
RUN npm install -g bun
WORKDIR /build/apps/web
COPY apps/web/package.json apps/web/bun.lock ./
RUN bun install --frozen-lockfile
COPY apps/web/ ./
RUN bun run build:embed

Installs Bun, SSR pre-renders the React app, and copies assets to server/frontend/.

Stage 2: Server Build

FROM golang:1.24-alpine AS backend
RUN apk add --no-cache gcc musl-dev
WORKDIR /build/server
COPY server/go.mod server/go.sum ./
RUN go mod download
COPY server/ ./
COPY --from=frontend /build/server/frontend ./frontend/
RUN CGO_ENABLED=1 GOOS=linux go build -ldflags="-s -w" -o /bedrud ./cmd/bedrud/main.go
# CGO is required for SQLite (uses C bindings)

Compiles the Go binary with the frontend embedded. CGO is enabled for SQLite support.

Stage 3: Runtime

FROM alpine:3.21
RUN apk add --no-cache ca-certificates tzdata
COPY --from=backend /bedrud /usr/local/bin/bedrud
EXPOSE 8090 7880
ENTRYPOINT ["bedrud"]
CMD ["run"]

Minimal Alpine image with just the binary, CA certificates, and timezone data.

Ports

Port	Service	Protocol
8090	API + Web UI	HTTP
7880	LiveKit	WebSocket + HTTP
50000-60000	RTC media	UDP

For LiveKit media streams, you may also need to expose the RTC UDP port range (default: 50000-60000).

Volumes

Mount a volume for persistent data:

docker run -d \
  --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -v bedrud-data:/var/lib/bedrud \
  bedrud

Configuration

Pass a custom configuration file:

docker run -d \
  --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -v /path/to/config.yaml:/etc/bedrud/config.yaml \
  -v bedrud-data:/var/lib/bedrud \
  bedrud run --config /etc/bedrud/config.yaml

Or use environment variables:

docker run -d \
  --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -e JWT_SECRET=my-production-secret \
  -e LIVEKIT_API_KEY=prodkey \
  -e LIVEKIT_API_SECRET=prodsecret \
  bedrud

Pre-built Images

Docker images are published to GitHub Container Registry on every release:

# Latest release
docker pull ghcr.io/bedrud-ir/bedrud:latest
 
# Specific version
docker pull ghcr.io/bedrud-ir/bedrud:v1.0.0

Docker Compose Example

services:
  bedrud:
    image: ghcr.io/bedrud-ir/bedrud:latest
    ports:
      - "8090:8090"
      - "7880:7880"
    volumes:
      - bedrud-data:/var/lib/bedrud
      - ./config.yaml:/etc/bedrud/config.yaml
    environment:
      - JWT_SECRET=change-me
    restart: unless-stopped
 
volumes:
  bedrud-data: