smilingxinyi/pocketbase repository overview

⁠PocketBase Docker Image (Multi-Arch)

PocketBase⁠ is an open-source Go backend, consisting of an embedded database (SQLite) with real-time subscriptions, built-in auth management, a convenient admin dashboard UI, and a simple REST-ish API.

⁠Features

• Lightweight: Minimal image size based on Alpine Linux.
• Multi-Arch Support: Supports linux/amd64, linux/arm64, and linux/arm/v7.
• Automated Builds: Mirrored and built to ensure availability on Docker Hub.
• Simple: Zero-config deployment with single-binary efficiency.

⁠Quick Start

Run the latest PocketBase container with a single command:

docker run -d \
  --name pocketbase \
  -p 8080:8080 \
  -v ./pb_data:/pb_data \
  # Replace with your Docker Hub username/repo if needed
  smilingxinyi/pocketbase:latest

Access the admin UI at: http://localhost:8080/_/⁠

⁠Docker Compose

For a more persistent and manageable setup, use the following docker-compose.yml:

services:
  pocketbase:
    image: smilingxinyi/pocketbase:latest
    container_name: pocketbase
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./pb_data:/pb_data
      - ./pb_public:/pb_public # Optional: for static frontend files
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://127.0.0.1:8080/api/health"]
      interval: 10s
      timeout: 5s
      retries: 3

⁠Configuration

⁠1. Persistent Data

PocketBase stores all data (SQLite database, settings, and uploaded files) in the /pb_data directory. Always mount this directory to a host volume to prevent data loss.

⁠2. Command Arguments

The default entrypoint runs ./pocketbase serve. You can pass additional flags:

# Example: Changing the internal port
docker run ... smilingxinyi/pocketbase:latest ./pocketbase serve --http="0.0.0.0:9090"

⁠Supported Architectures

This image is built using Docker Buildx for broad compatibility:

⁠Credits & Source

• PocketBase Official: pocketbase.io⁠
• Original Project: SmilingXinyi/pocketbase-docker⁠ (Forked for this build)
• License: This Docker image is released under the MIT License.