Create GettingStarted.md
This commit is contained in:
committed by
GitHub
parent
dbb139dfad
commit
d68e9e9589
28
docs/documentation/GettingStarted.md
Normal file
28
docs/documentation/GettingStarted.md
Normal file
@@ -0,0 +1,28 @@
|
|||||||
|
# Getting Started
|
||||||
|
## Docker
|
||||||
|
The Docker Container Repository is the most reliable and up-to-date distribution channel for LubeLogger.
|
||||||
|
You need to have Docker Windows installed and Virtualization enabled(typically a BIOS setting).
|
||||||
|
You will then clone the following files onto your computer from the repository _.env_ and _docker-compose.yml_ or _docker-compose-traefik.yml_ if you're using Traefik.
|
||||||
|
In the .env file you will find the following and here are the explanations for the variables.
|
||||||
|
```
|
||||||
|
LC_ALL=en_US.UTF-8 <- Locale and Language Settings, this will affect how numbers, currencies, and dates are formatted.
|
||||||
|
LANG=en_US.UTF-8 <- Same as above. Note that some languages don't have UTF-8 encodings.
|
||||||
|
MailConfig__EmailServer="" <- Email SMTP settings used only for configuring multiple users(to send their registration token and forgot password tokens)
|
||||||
|
MailConfig__EmailFrom="" <- Same as above.
|
||||||
|
MailConfig__UseSSL="false" <- Same as above.
|
||||||
|
MailConfig__Port=587 <- Same as above.
|
||||||
|
MailConfig__Username="" <- Same as above.
|
||||||
|
MailConfig__Password="" <- Same as above.
|
||||||
|
```
|
||||||
|
|
||||||
|
Once you're happy with the configuration, run the following commands to pull down the image and run container.
|
||||||
|
```
|
||||||
|
docker pull ghcr.io/hargata/lubelogger:latest
|
||||||
|
docker-compose up
|
||||||
|
```
|
||||||
|
By default the app will start listening at localhost:8080, this port can be configured in the docker-compose file.
|
||||||
|
|
||||||
|
## Windows Standalone Executable
|
||||||
|
Windows Standalone executables are provided on a request basis, and will usually be included with every other release.
|
||||||
|
To run the server, you just have to double click on CarCareTracker.exe
|
||||||
|
Occassionally you might run into an issue regarding a missing folder, to fix that, just create a "config" folder where CarCareTracker.exe is located.
|
||||||
Reference in New Issue
Block a user