Blame
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 1 | # Getting Started |
| 2 | ## Docker | |||
| 3 | The Docker Container Repository is the most reliable and up-to-date distribution channel for LubeLogger. | |||
| 53b5f4 | Hargata Softworks | 2024-10-14 19:43:53 | 4 | You need to have Docker installed and Virtualization enabled(typically a BIOS setting). |
| 5 | ||||
| cf899e | Hargata Softworks | 2024-04-19 14:54:45 | 6 | You will then clone the following files onto your computer from the repository |
| 7 | - docker-compose.yml(docker-compose-traefik.yml if using Traefik) | |||
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 8 | |
| be7452 | Hargata Softworks | 2025-10-19 15:04:07 | 9 | Run the following commands to pull down the image and run container. |
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 10 | ``` |
| 11 | docker pull ghcr.io/hargata/lubelogger:latest | |||
| 7da8aa | Hargata Softworks | 2024-04-23 22:17:27 | 12 | docker compose up -d |
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 13 | ``` |
| 14 | By default the app will start listening at localhost:8080, this port can be configured in the docker-compose file. | |||
| 15 | ||||
| 92fc09 | Hargata Softworks | 2024-07-31 18:25:52 | 16 | ### Kubernetes Deployment |
| 4cd21d | Hargata Softworks | 2024-07-31 18:16:33 | 17 | [Helm Chart](https://artifacthub.io/packages/helm/anza-labs/lubelogger) provided by [Anza-Labs](https://github.com/anza-labs) |
| 18 | ||||
| 120a93 | Hargata Softworks | 2024-07-03 15:17:07 | 19 | ### Edge-tagged Image |
| 20 | The `:edge` tagged Docker image may contain features that are considered experimental/not fully tested but have been merged into the main branch, use at your own risk. If you're building the Docker image manually and are cloning directly from the main branch of the repository, your local copy of the repository will contain those experimental features. | |||
| 21 | ||||
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 22 | ## Windows Standalone Executable |
| b3564d | Hargata Softworks | 2024-02-23 03:09:40 | 23 | Windows Standalone Executables(EXE) are provided, and can be found under assets for the [latest release](https://github.com/hargata/lubelog/releases/latest) |
| 24 | ||||
| ef104e | Hargata Softworks | 2024-09-28 20:04:54 | 25 |  |
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 26 | |
| 73b328 | Hargata Softworks | 2024-01-27 22:59:57 | 27 | To run the server, you just have to download the zip archive attached to the release, usually named LubeLogger_vNNN_win_x64.zip, extract the archive and double click on CarCareTracker.exe |
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 28 | |
| 29 | When using this approach, the default port the app will be listening on is 5000, so you will navigate to localhost:5000 | |||
| 30 | ||||
| 4a27cf | Hargata Softworks | 2025-04-15 23:13:34 | 31 | ### Run Executable in Background |
| 32 | ||||
| ba8e88 | Hargata Softworks | 2025-04-15 23:14:54 | 33 | The following steps describes how to run LubeLogger as a pseudo-service that is started whenever Windows is booted up. |
| 34 | ||||
| 35 | Note that LubeLogger cannot run as a true Windows Service as that will break cross-platform compatibility; however, it can run in the background with similar behaviors to a Windows Service. | |||
| 4a27cf | Hargata Softworks | 2025-04-15 23:13:34 | 36 | |
| 37 | 1. Launch `Task Scheduler` - should come with every copy of Windows | |||
| 38 | 2. Create a Task, note `Hidden` and `Run whether user is logged on or not` in `General` tab | |||
| 39 | ||||
| 40 |  | |||
| 41 | ||||
| 42 | 3. In `Triggers` tab, create a new trigger for `At startup` | |||
| 43 | ||||
| 44 |  | |||
| 45 | ||||
| 46 | 4. In `Actions` tab, create an action to launch `path\to\lubelogger\CarCareTracker.exe` and set the `Start in` to the folder the executable is in i.e.: `path\to\lubelogger` | |||
| 47 | ||||
| 48 |  | |||
| 49 | ||||
| 50 | 5. Click `Ok` to create the task, then right click on the task and click `Run` | |||
| 51 | 6. LubeLogger should now run in the background | |||
| 52 | ||||
| 53 |  | |||
| 54 | ||||
| 55 |  | |||
| 56 | ||||
| 1c503f | Hargata Softworks | 2025-04-15 23:18:07 | 57 | 7. To stop LubeLogger, right click on the Task and select `End` |
| 58 | ||||
| 985a94 | Hargata Softworks | 2024-09-14 21:03:49 | 59 | ## Linux Baremetal |
| ef104e | Hargata Softworks | 2024-09-28 20:04:54 | 60 | Linux executables are provided and can be found under assets for the [latest release](https://github.com/hargata/lubelog/releases/latest) |
| 61 | ||||
| b11c9f | Hargata Softworks | 2024-10-04 20:02:24 | 62 | [Youtube Tutorial](https://www.youtube.com/playlist?list=PL2aZOA2wNP8tR21myT_s0T0tneoRi0vdT) |
| 97c2ea | Hargata Softworks | 2024-10-04 19:57:32 | 63 | |
| ef104e | Hargata Softworks | 2024-09-28 20:04:54 | 64 | To run the Linux executable, download the zip file named LubeLogger_vNNN_linux_x64.zip, extract it and run the following commands: |
| 65 | ||||
| 985a94 | Hargata Softworks | 2024-09-14 21:03:49 | 66 | ``` |
| 67 | chmod 777 ./CarCareTracker | |||
| 68 | ./CarCareTracker | |||
| 69 | ``` | |||
| 70 | ||||
| fe852d | Hargata Softworks | 2025-10-07 18:25:02 | 71 | **Note:** `chmod 777` above is only used to rule out permission quirks/issues, please restrict the permissions to the lowest acceptable level once you have verified that LubeLogger can be executed on your machine. |
| 3abfdf | Hargata Softworks | 2024-11-13 14:50:16 | 72 | |
| 0c19e1 | Hargata Softworks | 2024-01-27 22:56:52 | 73 | ## Test that It Works |
| 74 | Whichever path you choose, once you get the app up and running, just navigate to the IP address and port the server is listening to and you should be able to see the app | |||
| f41be7 | Hargata Softworks | 2025-10-07 18:26:07 | 75 | |
| 76 | Next steps: [[Configuring Server Settings|Installation/Server Settings]] |