rcmelendez/lapua repository overview

⁠Lapua Docker image

Lapua (Low Alerts Python Utility Application) is an application developed by Devo⁠. This Docker image includes the Lapua Server and the Lapua Monitor.

⁠Release info

This Docker image was built with the following versions:

• Python 3.9.6
• Alpine Linux 3.14
• Lapua 1.1.5
• Devo Python SDK 3.4.2

⁠How to use this image

⁠1. Clone the GitHub repo

git clone https://github.com/rcmelendez/devo-lapua-docker.git

⁠2. Modify the config files

• docker-compose.yml⁠: change Lapua and MySQL passwords.
• data/conf.json⁠: change the Lapua server name, MySQL password, certificate/key names, and Devo endpoint.
• data/monitor.yaml⁠: modify the name, address, and certificate/key names.

⁠3. 3. Get your Devo certs and key

In the Devo webapp⁠, go to Administration -> Credentials -> X.509 Certificates. Download the Devo chain and domain certificates along with the domain key into the data/certs⁠ directory.

⁠4. Run the image

docker-compose up -d

⁠5. Validate the data in Devo

Go to Devo⁠ and check that there events in devo.monitor.lapua.out and my.app.lapua.monitor.

⁠6. Add some jobs

Once the Lapua Server and Lapua Monitor are up and running, copy or move the desired jobs to the data/config⁠ directory. For your convenience, you can modify the sample jobs provided (roberto__box_unix__1h.json⁠ and roberto__siem_logtrust_collector_counter__1h.json⁠) to suit your needs.

⁠7. Validate the execution of the jobs

If the period selected is 1h, then you should have data for that job in my.app.monitor.inactivity in about an hour (and every 1h).

⁠License

This Docker image is licensed under the terms of the MIT License. See the LICENSE⁠ file for details.

⁠Contact

Find me as rcmelendez on LinkedIn⁠, Medium⁠, and GitHub⁠.