sop-hub

sop-hub

Docker app from allornothing's Repository

Self-hosted step-by-step visual guide builder, with AI help from either a local model or a cloud provider.

Requirements

Internet access is optional -- only needed if you point it at a cloud AI provider. Everything else, including local AI via your own Ollama instance, works fully offline/on-LAN.
Overview
Self-hosted step-by-step visual guide builder, with AI help from either a local model or a cloud provider. Capture a process two ways -- upload screenshots manually in the editor, or install the included Chrome extension and just click through the workflow; it auto-captures a screenshot and click position for every click and uploads the whole walkthrough as a new guide in one step. From there, AI can describe each screenshot, write the guide's title and summary, rewrite step text for clarity, and answer questions about a guide in a chat panel -- all routed through one provider abstraction so local (Ollama) and cloud (Anthropic Claude, OpenAI, or any OpenAI-compatible endpoint) are interchangeable per request. Finished guides publish to a public read-only share link, or export straight to PDF, HTML, or Markdown with embedded step images. Everything -- Postgres, the API, and the built frontend -- runs in this one container. SET JWT_SECRET before starting (any long random string). AI is optional and defaults to a local Ollama instance you point it at (does not run inside this container); set the Anthropic/OpenAI/custom variables instead if you'd rather use a cloud provider, or skip AI entirely and use SOP-Hub as a plain guide editor. Everything lives under the single /config mount: the embedded Postgres database and all uploaded step screenshots. Back that one directory up and you've backed up the whole app.

SOP-Hub

Turn any workflow into a step-by-step visual guide. Record it with the Chrome extension (it grabs a screenshot for every click) or upload screenshots yourself, then edit, blur out anything private, and share it. It runs on your own hardware in one Docker container.

What you get:

  • Quick capture. Click through a process once and the guide builds itself.
  • AI help, your choice. Local Ollama or a cloud provider (Claude, OpenAI, or any compatible endpoint) can describe steps, write titles and rewrite text.
  • Easy sharing. Publish a read-only link, or export to PDF, HTML or Markdown.

Image: allornothing/sop-hub · Source: aon082910/sop-hub

Install

docker run -d --name sop-hub -p 8080:8080 \
  -e JWT_SECRET=$(openssl rand -hex 32) \
  -e PUID=99 -e PGID=100 \
  -v /mnt/user/appdata/sop-hub:/config \
  allornothing/sop-hub:latest

Compose users: copy .env.example to .env, set a real JWT_SECRET, and run docker compose up -d --build. On Unraid, the template is in AoN-Unraid-Apps.

Setting Default What it's for
Port 8080 Web UI
/config /mnt/user/appdata/sop-hub Database and uploads
JWT_SECRET none, required Signs login tokens
AI_DEFAULT_PROVIDER ollama ollama, anthropic, openai or custom
OLLAMA_BASE_URL http://ollama:11434 Where your Ollama lives

For cloud AI, set the matching *_API_KEY variable.

Help

Open an issue. MIT licensed.

Categories

Download Statistics

4,106
Total Downloads

Related apps

Links

Details

Repository
allornothing/sop-hub:latest
Last Updated2026-09-07
First Seen2026-09-03

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp

Web UI / API port

Target
8080
Default
8080
Value
8080
AppdataPathrw

Embedded Postgres database and all uploaded step screenshots -- the only folder you need to back up

Target
/config
Default
/mnt/user/appdata/sop-hub
Value
/mnt/user/appdata/sop-hub
PUIDVariable

Unraid's nobody user -- keeps appdata editable from the host

Default
99
Value
99
PGIDVariable

Unraid's users group

Default
100
Value
100
TZVariable

Timezone for dates shown in the app

Default
Etc/UTC
Value
Etc/UTC
JWT SecretVariable

Required. Any long random string -- used to sign auth tokens. Generate one with: openssl rand -hex 32

Target
JWT_SECRET
AI ProviderVariable

ollama (local) | anthropic | openai | custom -- which AI backend features use by default

Target
AI_DEFAULT_PROVIDER
Default
ollama
Value
ollama
Ollama Base URLVariable

Only used when AI Provider = ollama. Point at your own Ollama instance -- it does not run inside this container.

Target
OLLAMA_BASE_URL
Default
http://ollama:11434
Value
http://ollama:11434
Ollama ModelVariable

Use a vision-capable model (e.g. llava) so screenshot-description AI works

Target
OLLAMA_MODEL
Default
llava
Value
llava
Anthropic API KeyVariable

Only used when AI Provider = anthropic

Target
ANTHROPIC_API_KEY
Anthropic ModelVariable
Target
ANTHROPIC_MODEL
Default
claude-sonnet-5
Value
claude-sonnet-5
OpenAI API KeyVariable

Only used when AI Provider = openai

Target
OPENAI_API_KEY
OpenAI ModelVariable
Target
OPENAI_MODEL
Default
gpt-4o-mini
Value
gpt-4o-mini
Custom OpenAI-compatible Base URLVariable

Only used when AI Provider = custom -- any OpenAI-compatible API (LM Studio, vLLM, OpenRouter, etc.)

Target
CUSTOM_OPENAI_BASE_URL
Custom OpenAI-compatible API KeyVariable
Target
CUSTOM_OPENAI_API_KEY
Custom OpenAI-compatible ModelVariable
Target
CUSTOM_OPENAI_MODEL
Postgres UserVariable

Embedded database user -- not exposed outside the container

Target
POSTGRES_USER
Default
sophub
Value
sophub
Postgres PasswordVariable

Embedded database password -- not exposed outside the container

Target
POSTGRES_PASSWORD
Default
sophub
Value
sophub
Postgres DatabaseVariable
Target
POSTGRES_DB
Default
sophub
Value
sophub