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
Overview
Readme
View on GitHubSOP-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
Related apps
Explore more like this
Explore allLinks
Details
allornothing/sop-hub:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8080]/- Network
bridge- Shell
sh- Privileged
- false
Template configuration
Web UI / API port
- Target
- 8080
- Default
- 8080
- Value
- 8080
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
Unraid's nobody user -- keeps appdata editable from the host
- Default
- 99
- Value
- 99
Unraid's users group
- Default
- 100
- Value
- 100
Timezone for dates shown in the app
- Default
- Etc/UTC
- Value
- Etc/UTC
Required. Any long random string -- used to sign auth tokens. Generate one with: openssl rand -hex 32
- Target
- JWT_SECRET
ollama (local) | anthropic | openai | custom -- which AI backend features use by default
- Target
- AI_DEFAULT_PROVIDER
- Default
- ollama
- Value
- ollama
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
Use a vision-capable model (e.g. llava) so screenshot-description AI works
- Target
- OLLAMA_MODEL
- Default
- llava
- Value
- llava
Only used when AI Provider = anthropic
- Target
- ANTHROPIC_API_KEY
- Target
- ANTHROPIC_MODEL
- Default
- claude-sonnet-5
- Value
- claude-sonnet-5
Only used when AI Provider = openai
- Target
- OPENAI_API_KEY
- Target
- OPENAI_MODEL
- Default
- gpt-4o-mini
- Value
- gpt-4o-mini
Only used when AI Provider = custom -- any OpenAI-compatible API (LM Studio, vLLM, OpenRouter, etc.)
- Target
- CUSTOM_OPENAI_BASE_URL
- Target
- CUSTOM_OPENAI_API_KEY
- Target
- CUSTOM_OPENAI_MODEL
Embedded database user -- not exposed outside the container
- Target
- POSTGRES_USER
- Default
- sophub
- Value
- sophub
Embedded database password -- not exposed outside the container
- Target
- POSTGRES_PASSWORD
- Default
- sophub
- Value
- sophub
- Target
- POSTGRES_DB
- Default
- sophub
- Value
- sophub