Setup the 2log.io Server Application
The easiest way to set up your 2log instance is to use Docker.
The easiest way to set up your 2log instance is to use the Dockerfile provided in the repository. First, make sure that Docker is installed with the associated tool docker-compose.
mkdir ~/2log cd ~/2log wget https://gitlab.com/2log-io/2log.io/-/raw/main/docker/docker-compose.yaml docker-compose up
By default, the WebAssembly frontend can be reached via Port 8080. If the server is running on your local machine, just visit http://localhost:8080 in your web browser and the UI should come up. You can now login into your instancy by accessing the WebSocket service which is by default accessible via port 4711. To check your instance is up and just type
ws://localhost:4711. The initial default login is “admin” with passwort “password”. Don’t forget to change the password after the first login!
Note:The frontend does currently not work in mobile browsers. Since the frontend is written in Qt, it can easily be compiled as a native Android *.apk. (Which is much cooler anyway).
Setup Mail Server
The mail server can be configured directly via the environment variables. The easiest way to define these settings is directly in the docker-compose file.
#--------- Mail Server config #- MAIL_HOST=smtp.mydomain.com #- MAIL_USER=admin #- MAIL_PASS=password #- MAIL_ADDRemail@example.com //sender eMail address #- MAIL_CONNECTION_TYPE=TLS // or SSL or TCP #- MAIL_SENDER=2log.io // readable sender name (optional) #- MAIL_PORT=587
|MAIL_HOST||How to reach the mailserver||smtp.mydomain.com|
|MAIL_USER||The login string||admin|
|MAIL_PASS||The mail server password||xF5s42F1337@r!|
|MAIL_ADDR||Sender eMail Adessefirstname.lastname@example.org|
|MAIL_CONNECTION_TYPE||Security settings. Supported are TLS, SSL or TCP||TLS|
|MAIL_PORT||The port where the mail server is listening||587|
Update the 2log.io instance
To get the latest features and bug fixes it is recommended to update the 2log server regularly.
Attention!The update process must necessarily happen outside of the operating hours, as all running processes are interrupted by the update process!
Updating the 2log instance when using the Docker Compose file is very simple. Just enter the following commands in the command line:
docker-compose pull 2log docker-compose up
Tip:To get automatic updates, it is worth taking a look at Watchtower: https://containrrr.dev/watchtower/
All operational data of the 2log instance is stored in the folder
./2log.io. It is strongly recommended to back up the folder at regular intervals.