Commit 3fb9e8
2025-01-02 21:11:26 Hargata Softworks: x| /dev/null .. installation/upgrade.md | |
| @@ 0,0 1,58 @@ | |
| + | # 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|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 file you copied. |
| + | |
| + | 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. |