Search

PythonReactSEOPDF
GitHub Skill

no-docker-setup

Set up full production-like backend (PostgreSQL + API + Worker) without Docker. Use for testing durable workflows, database persistence, or when DEV_MODE is insufficient.

everruns☆ 2 Repository stars0 Repository forks

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

View source ↗Guides

Skill instructions

No-Docker Setup

Full production-like backend without Docker: PostgreSQL + API + Worker.

When to Use

Mode Use Case
just start-dev --no-watch Quick testing, UI work, in-memory (no persistence)
This skill Durable workflows, database testing, persistence needed
just start-all Full setup with Docker (easiest if Docker available)

What It Does

  1. Sets up fresh PostgreSQL cluster at /tmp/pgdata
  2. Runs just start-all --no-watch --no-docker --no-ui
    • API server auto-applies migrations on startup
    • Starts API server (port 9000)
    • Starts Worker (port 9001)

Quick Start

# Prerequisites: PostgreSQL 16+, jq, API key
sudo -E .claude/skills/no-docker-setup/scripts/start.sh

Prerequisites

  1. PostgreSQL 16+ - apt-get install postgresql-16
  2. jq - apt-get install jq
  3. API Key - OPENAI_API_KEY or ANTHROPIC_API_KEY
  4. Root access - For PostgreSQL cluster initialization

Architecture

PostgreSQL (port 5432) → API (port 9000) → Worker (port 9001)
     ↓                       ↓                  ↓
  /tmp/pgdata           HTTP + gRPC        Durable workflows

Alternative: Manual Setup

If you already have PostgreSQL running:

export DATABASE_URL="postgres://user:pass@localhost:5432/everruns"
just start-all --no-watch --no-docker --no-ui

Testing

curl http://localhost:9000/health
cargo test

Examples

Read the usage examples in the source repository.

View source ↗

Source history

Indexed on
2026-01-20
Index updated
2026-01-26
Branch
main

Index and sync dates describe this directory. View the source repository for code history.

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!