# 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

![](/Installation/Upgrade/a/image-1735849586472.png)

A zip file will be downloaded to your computer.

### Automated Method

Use a script to hit the API endpoint for creating backups, see [[API|Advanced/API#example-use-cases]]

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.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9