simbashlog-debian-docker-template: Template for Debian Docker containers with simbashlog

Description

This template is intended to be used as a basis for creating a new Docker container with simbashlog and cronjob support. The container is based on Debian.

Getting Started

The easiest way is to download and run the install.sh script.

It will guide you through the installation process and create the necessary files and directories so that you don't have to worry about anything setting up manually.

First, go to the directory where you want to install the container.

The following command will download the installation script, make it executable, execute it and then delete it:

wget -q -O install.sh https://raw.githubusercontent.com/fuchs-fabian/simbashlog-debian-docker-template/refs/heads/main/install.sh && \
chmod +x install.sh && \
./install.sh && \
rm install.sh

As the simbashlog-notifier does not work straight away, the container must be shut down and then the configuration file under volumes/config/ must be adapted.

If a notifier is used that requires additional files, these must be created on the host and mounted. Alternatively, the files can also be created in the container if the corresponding bind mounts have been set beforehand.

If the cronjob schedule or other settings are to be adjusted, the Docker container must be shut down briefly and the .env file adjusted:

docker compose down

nano .env

The .env file should look like this:

LOG_LEVEL=6
CRON_SCHEDULE=*/10 * * * *
GIT_REPO_URL_FOR_SIMBASHLOG_NOTIFIER=''

As the log files are mounted on the host by default, the files could become very large in the long term. The log files should therefore be deleted from time to time.

The log files are located under volumes/logs/.

Bugs, Suggestions, Feedback, and Needed Support

If you have any bugs, suggestions or feedback, feel free to create an issue or create a pull request with your changes.

Support simbashlog

If you like simbashlog's ecosystem, you think it is useful and saves you a lot of work and nerves and lets you sleep better, please give it a star and consider donating.

---

This repository uses simbashlog (LICENSE).

Copyright (C) 2024 Fabian Fuchs