docs: Add development setup and Docker build instructions to README, update config examples, and fix relative links.

Author: test

.github/workflows/docker-publish.yml

@@ -0,0 +1,59 @@
+name: Build and Publish Docker Image
+
+on:
+  push:
+    branches: [ "main", "master" ]
+    tags: [ 'v*.*.*' ]
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log into registry ${{ env.REGISTRY }}
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=latest,enable=${{ github.ref == format('refs/heads/{0}', github.event.repository.default_branch) }}
+            type=semver,pattern={{version}}
+            type=sha
+
+      - name: Build and push Docker image
+        id: build-and-push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

Dockerfile

@@ -1,17 +1,38 @@
-ARG BUN_VERSION=1.2.21
-
-FROM oven/bun:${BUN_VERSION}-alpine AS base
+# -- Build Stage --
+FROM oven/bun:1.2-alpine AS build
 WORKDIR /app
 
-COPY package.json bun.lock* tsconfig.json ./
+# Copy dependency manifests
+COPY package.json bun.lock* ./
 
-RUN bun install --production --frozen-lockfile
+# Install ALL dependencies (including devDependencies for testing/build)
+RUN bun install --frozen-lockfile
 
+# Copy the rest of the source
 COPY . .
 
+# -- Final Stage --
+FROM oven/bun:1.2-alpine AS release
+WORKDIR /app
+
+# Copy production dependencies only
+COPY --from=build /app/package.json /app/bun.lock* ./
+RUN bun install --production --frozen-lockfile
+
+# Copy the source code
+COPY --from=build /app/src ./src
+
+# Create logs and config directories with correct permissions
+RUN mkdir -p /logs /config && \
+    chown -R bun:bun /logs /config /app
+
+# Use the non-root user 'bun' provided by the base image
+USER bun
+
 EXPOSE 8481
 
-VOLUME /logs
-VOLUME /config
+# Persist logs and config
+VOLUME ["/logs", "/config"]
 
+# Start the application
 CMD ["bun", "run", "src/main.ts", "/logs", "/config/config.yaml"]

docker-compose.yml

@@ -0,0 +1,13 @@
+services:
+  redirecterr:
+    image: ghcr.io/${GITHUB_REPOSITORY_OWNER}/redirecterr:latest
+    container_name: redirecterr
+    restart: unless-stopped
+    ports:
+      - 8481:8481
+    volumes:
+      - ./config:/config
+      - ./logs:/logs
+    environment:
+      - LOG_LEVEL=info
+      - TZ=UTC