Upgrade Guide

Comprehensive upgrade guide for Docker and Standalone Windows/Linux Executables.

Regardless of how your LubeLogger instance is installed/configured, we highly recommend that you create a backup before updating, it will take less than two minutes of your time and save you a lot of headache if something goes wrong.

Create A Backup

Manual Method

Login as the root/superuser to your LubeLogger instance, navigate to the Settings tab and create a backup

A zip file will be downloaded to your computer.

Automated Method

Use a script to hit the API endpoint for creating backups, see API

You can automate the script using a cron job to create daily or weekly backups.

Docker

1. Create a backup
2. Verify your Docker Volumes
3. Run the command docker compose pull
4. The, run the command docker compose up to start the container

If your Docker Volumes are bound and persisted correctly, you should have no loss of data.

Windows/Linux Standalone

The Easy Way

1. Create a backup
2. Important: Make a copy of appsettings.json
3. Download the latest version of LubeLogger from the Release section
4. Extract the archive over your existing LubeLogger installation.
5. Replace appsettings.json with the copy.

This method can be inconsistent due to the various approach users can use to extract the archive, certain archive tools will delete all folders in the destination path that don't exist within the archive. If your LubeLogger instance is missing data, restore the backup.

The Consistent Way

1. Create a backup
2. Make a copy of the following files and folders:

• appsettings.json
• config\UserConfig.json
• data\cartracker.db
• wwwroot\images
• wwwroot\documents
• wwwroot\translations

3. Download the latest version of LubeLogger from the Release section
4. Extract the archive over your existing LubeLogger installation.
5. Replace the files and folders with the files and folders you made copies of.