Docker Deployment

PocketPaw can be containerized with Docker for easy deployment and isolation.

Dockerfile

FROM python:3.11-slim

WORKDIR /app

# Install system dependencies
RUN apt-get update && apt-get install -y \
    git \
    && rm -rf /var/lib/apt/lists/*

# Install PocketPaw
RUN pip install pocketpaw[recommended]
# Or: RUN curl -fsSL https://pocketpaw.xyz/install.sh | sh

# Create data directory
RUN mkdir -p /root/.pocketclaw

# Expose dashboard port
EXPOSE 8000

# Start PocketPaw
CMD ["pocketpaw"]

Docker Compose

version: '3.8'

services:
  pocketpaw:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - pocketpaw-data:/root/.pocketclaw
    environment:
      - POCKETCLAW_ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - POCKETCLAW_DASHBOARD_HOST=0.0.0.0
      - POCKETCLAW_DASHBOARD_PORT=8000
      - POCKETCLAW_TOOL_PROFILE=coding
    restart: unless-stopped

volumes:
  pocketpaw-data:

With Ollama

To use Ollama for local models alongside PocketPaw:

version: '3.8'

services:
  pocketpaw:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - pocketpaw-data:/root/.pocketclaw
    environment:
      - POCKETCLAW_ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - POCKETCLAW_MEM0_AUTO_LEARN=true
      - POCKETCLAW_MEM0_LLM_PROVIDER=ollama
      - POCKETCLAW_MEM0_LLM_MODEL=llama3.2
      - POCKETCLAW_MEM0_EMBEDDER_PROVIDER=ollama
      - POCKETCLAW_MEM0_EMBEDDER_MODEL=nomic-embed-text
      - OLLAMA_HOST=http://ollama:11434
    depends_on:
      - ollama
    restart: unless-stopped

  ollama:
    image: ollama/ollama
    volumes:
      - ollama-data:/root/.ollama
    ports:
      - "11434:11434"
    restart: unless-stopped

volumes:
  pocketpaw-data:
  ollama-data:

After starting, pull the required models:

docker compose exec ollama ollama pull llama3.2
docker compose exec ollama ollama pull nomic-embed-text

Running

# Build and start
docker compose up -d

# View logs
docker compose logs -f pocketpaw

# Stop
docker compose down

Persistent Data

Mount the ~/.pocketclaw directory as a volume to persist:

Configuration
Session history
Memory data
OAuth tokens
Audit logs
MCP server configs

Browser Automation in Docker

For browser automation, add Playwright dependencies:

FROM python:3.11-slim

# Install Playwright dependencies
RUN apt-get update && apt-get install -y \
    libnss3 libnspr4 libdbus-1-3 libatk1.0-0 \
    libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 \
    libxcomposite1 libxdamage1 libxrandr2 libgbm1 \
    libasound2 libpango-1.0-0 libcairo2 \
    && rm -rf /var/lib/apt/lists/*

RUN pip install pocketpaw[recommended,browser]
RUN playwright install chromium

EXPOSE 8000
CMD ["pocketpaw"]

Last updated: February 12, 2026

Edit this page

Was this page helpful?