nxtgencat/pocketbase repository overview

⁠PocketBase Docker

⁠Overview

This Docker image provides a lightweight, ready-to-use PocketBase⁠ instance that works across multiple architectures. PocketBase is an open source backend consisting of embedded database (SQLite) with realtime subscriptions, built-in auth management, convenient dashboard UI and simple REST-ish API.

⁠Features

• Multi-architecture support: amd64, arm64, and armv7
• Small footprint: Optimized image size for faster deployments
• Easy configuration: Simple setup with environment variables
• Volume mounting: Persistent data and custom configurations
• Health checks: Built-in container health monitoring

⁠Quick Start

docker run -d \
  --name pocketbase-app \
  --restart unless-stopped \
  -p 8090:8090 \
  -e PB_SUPERUSER_EMAIL="[email protected]" \
  -e PB_SUPERUSER_PASSWORD="Password123!" \
  -e PB_ENCRYPTION_KEY="a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" \
  -v pocketbase-app:/pocketbase \
  --health-cmd="curl -f http://localhost:8090/api/health" \
  --health-interval=30s \
  --health-timeout=10s \
  --health-retries=3 \
  nxtgencat/pocketbase:latest

Access the admin UI at http://localhost:8090/_/⁠ after running.

⁠Tag Versioning

⁠Docker Compose (Recommended)

services:
  pocketbase:
    image: nxtgencat/pocketbase:latest
    container_name: pocketbase-app
    restart: unless-stopped
    ports:
      - "8090:8090"
    environment:
      - PB_SUPERUSER_EMAIL="[email protected]"
      - PB_SUPERUSER_PASSWORD="Password123!"
      - PB_ENCRYPTION_KEY="a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
    volumes:
      - pocketbase-app:/pocketbase
    healthcheck:
      test: [ "CMD", "curl", "-f", "http://localhost:8090/api/health" ]
      interval: 30s
      timeout: 10s
      retries: 3
    
volumes:
  pocketbase-app: {}

⁠Environment Variables

⁠Volumes

⁠Custom Configuration

For advanced configuration, create a pocketbase.json file and mount it to /pb_data/pocketbase.json.

⁠Health Checks

The container includes a built-in health check endpoint at /api/health that returns HTTP 200 when PocketBase is running properly.

⁠Resources

• PocketBase Documentation⁠
• Docker Hub Repository⁠
• GitHub Repository⁠

⁠License

This Docker image is distributed under the same license as PocketBase. See PocketBase's license⁠ for details.