pixlstash
★ 114About
Community Ratings
No ratings yetNew this week
Read recap →Features
- Semantic search across images and document text
- Face recognition, people grouping, and likeness search
- AI tagging, captioning, object detection, and segmentation
- ComfyUI workflow integration, editing, and recipe reruns
- Image inpainting, cropping, rotation, and upscaling
- Watched folders, imports, captions, and folder layouts
- Image exports with captions and sidecars
- Multiple libraries and model-shelf management
- LoRA training and training-run reports
- CLI library management and backup restoration
Details
- Last Updated
- Nov 17, 2026
- Created
- Oct 12, 2025
- Requirements
- ComfyUI for workflow integrationAI-toolkit for LoRA training
- Default Port
- 9537headless server web interface
- Backup & Export
- CLI backup and restoreZIP exportFolder export
- Privacy & Independence
- Cloud: OptionalOffline Capable
- Deployment
Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container
Run pixlstash yourself
Pick how much you want to manage.
netcupBest match
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Hetzner
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
DigitalOcean
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
1 more way to host
Some links earn us a commission. netcup pays us one and is our preferred VPS host.
Is this your project? Sponsor a listing
Run pixlstash with Docker Compose
Compose file from the pixlstash project repository.
1 service
no resource limits declared
needs persistent storage (1 volume)
docker-compose.yml · @ 636d8c7 · scanned Nov 3, 2026
services:
pixlstash:
build:
context: .
dockerfile: Dockerfile
image: pixlstash:latest
container_name: pixlstash
restart: unless-stopped
# GPU access via nvidia-container-runtime.
# Requires: sudo nvidia-ctk runtime configure --runtime=docker && sudo systemctl restart docker
runtime: nvidia
ports:
- "9537:9537"
volumes:
# All persistent data (config, images/database, downloaded AI models) lives
# under the container user's home directory, mirroring a regular Linux install:
# ~/.config/pixlstash/server-config.json
# ~/.config/pixlstash/images/ ← default image root + vault.db
# ~/.local/share/pixlstash/downloaded_models/
#
# To store images on your real filesystem instead, add a bind mount and set
# PIXLSTASH_IMAGE_ROOT (see .env.example).
- pixlstash-home:/home/pixlstash
environment:
PIXLSTASH_HOST: "0.0.0.0"
PIXLSTASH_PORT: "9537"
NVIDIA_VISIBLE_DEVICES: all
NVIDIA_DRIVER_CAPABILITIES: compute,utility
# Optional: uncomment + add a bind mount to put images on your real filesystem
# PIXLSTASH_IMAGE_ROOT: "/mnt/photos"
# First run only: provision the owner account. Inside a container the
# server never sees loopback traffic, so the in-browser first-run setup
# is blocked by design. Uncomment BOTH lines, start the container once,
# log in, then remove them again (they are ignored — with a log message —
# once the account is claimed, but should not linger in the environment).
# PIXLSTASH_INITIAL_USERNAME: "owner"
# PIXLSTASH_INITIAL_PASSWORD: "change-me-now"
volumes:
pixlstash-home:
This file may be out of date. Check the pixlstash website for current setup steps.
Tags
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.
Alternatives to pixlstash
PhotoPrism
LibrePhotos
PhotoStructure
HomeGallery
Photofield
Damselfly
Photoview
Imagor Studio
Related Software
ComfyUI
imagor
LocalAI
LLM Harbor
SillyTavern
Digicard
LibreChat
