Upgrading PixlStash to version

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

⚠️ Back your library up first by copying the library folder somewhere safe while PixlStash is stopped. Opening a library with 1.11 adds columns to its database. And if you are coming from 1.9 or earlier, the 1.10 library upgrade is not backwards compatible: once a library has been opened by 1.10 or later, an older version cannot open it again.

New in 1.11

Explore what changed before you upgrade

Add a library from Settings and let the folder answer for itself: PixlStash reads a folder of pictures where it sits and turns your folder names into projects, people and sets, without moving or renaming a file. Plus a folder layout for the pictures a library writes next and export straight into a folder.

Open the What's New page →

PixlStash 1.11: a folder of pictures being read, with each folder level labelled as a project, a person or a set

🐍

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

Simple 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.