Upgrading PixlStash to version

Choose the box that matches how you installed PixlStash and follow the steps to get the latest version.

🐍

pip install

Python virtual environment / PyPI

1 — Activate your virtual environment Linux / MacOS:

.venv/bin/activate

Windows

.venv\Scripts\activate

2 — Upgrade

pip install --upgrade pixlstash

3 — Restart the server

Stop the running server and start it again with pixlstash-server (or however you normally launch it). The new version is active immediately.

🪟

Windows installer

One-click installer / .exe bundle

1 — Download the new installer

Go to the latest release on GitHub and download the Windows .exe installer.

2 — Stop the running server

Close the PixlStash server window or stop the background service before running the installer.

3 — Run the installer

Double-click the downloaded installer and follow the prompts. It will replace the existing installation in-place. Your image library and settings are preserved.

🐳

Docker

docker-compose or standalone container

1 — Pull the latest image

CPU

docker pull ghcr.io/pikselkroken/pixlstash:latest

GPU

docker pull ghcr.io/pikselkroken/pixlstash:latest-gpu

2 — Restart the container

docker stop pixlstash && docker rm pixlstash

Then re-run your original docker run command — see the install guide for CPU or GPU inference.

⚠️ Make sure your data folder is mounted as a volume so it survives the container replacement. See CPU mount setup or GPU mount setup.

📦

From source

git clone / editable install

1 — Pull the latest code

cd pixlstash git pull

2 — Re-install dependencies

pip install -e .

3 — Rebuild the frontend

cd frontend && npm ci && npm run build

4 — Restart the server

Stop and restart pixlstash-server (or python -m pixlstash.app) to load the new code.

Upgrading PixlStash to version

Explore what changed before you upgrade