Upgrading Light Store
Learn how to easily upgrade store versions with minimal downtime and no data-loss.
Using the installer (simplest)
The bundled installer upgrades the store for you. It downloads the new image, restarts the containers and keeps all of your data. The upgrade.sh script from older versions has been replaced by this flow.
In your store directory, start the installer:
./install.shChoose Upgrade version from the main menu.
This entry only shows up when the installer detects a Light Store Docker project in the current directory.
Pick the version to upgrade to. Newer versions are downloaded from the mirror; Build image from source is available as well if you prefer to build locally.
Confirm. The containers are stopped, the new image is loaded and pinned in docker-compose.override.yml, and the store starts again. The first boot after an upgrade can take a minute while the database migrates.
Rolling back
The downloaded lightstore-<version>-<arch>.tar.gz archives stay in the store directory and are listed as local
on the version screen, so an upgrade can be undone by running Upgrade version again and picking the older one.
Using Docker
Download the new zip from nortex.dev or the BuiltByBit page.
Shut down the store:
docker compose downDelete all old source folders:
rm -rf app/ database/ resources/ config/ routes/Upload the new zip and unzip using unzip, like in the installation procedure.
Run compose up to start:
docker compose up -d --buildManually
Download the new zip from the BuiltByBit page
On the remote machine, delete all old source folders:
rm -rf app/ database/ resources/ config/ routes/Upload the new zip and unzip using unzip, like in the installation procedure.
Follow installation steps for building assets.