Bernhard.Linz/mailGraph
1
0
Fork 0
mirror of https://github.com/moudsen/mailGraph synced 2025-05-09 21:14:27 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

v0.9.1 - Initial public beta release for testing purposes

Browse Source
This commit is contained in:
Mark Oudsen 2025-05-05 19:07:24 +02:00
parent 12c9f1e331
commit fbcc359f05
1 changed files with 14 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docker/README.md
View File

@ -11,18 +11,25 @@ WORK-IN-PROGRESS
mkdir /opt/Zabbix-Mailgraph/config mkdir /opt/Zabbix-Mailgraph/config
mkdir /opt/Zabbix-Mailgraph/templates mkdir /opt/Zabbix-Mailgraph/templates
``` ```
- Create a new `config.json` in the config directory and configure accordingly (refer to the wiki for more detailed instructions or use the `config.json.template` as a boilerplate). - Create a new `config.json` in the above `config` directory and configure accordingly (refer to the wiki for more detailed instructions or use the `config.json.template` as a boilerplate).
- Deploy the mailGraph container, preferably using `docker-compose`. - Copy the `plain.template` and `html.template` into the above `templates` directory.
- Deploy the mailGraph container, preferably using `docker-compose`:
-- Adopt and configure the `docker-compose.yml` file to your needs; -- Adopt and configure the `docker-compose.yml` file to your needs;
-- Configure `RESTART_POLICY=unless-stopped` in a file name `.env` (same directory as `docker-compose`). -- Configure `RESTART_POLICY=unless-stopped` in a file name `.env` (same directory as `docker-compose`).
- Start the container: `docker-compose -D up` - Start the container: `docker-compose -D up`.
- Follow best-practices on your applicable Linux version to ensure the container is started after a reboot. - Follow best-practices on your applicable Linux version to ensure the container is started after a reboot.
When running:
- mailGraph is exposed on port `9080` (point the Zabbix webhook to this location).
- Apache logging is exposed on `/opt/Zabbix-Mailgraph/apache.log`.
## Testing and Debugging ## ## Testing and Debugging ##
- Display currently running containers `docker ps` - Display currently running containers `docker ps`.
- Execute `docker exec -it <container name> sh` for a shell into the container - Execute `docker exec -it <container name> sh` for a shell into the container.
- Following the instructions in the Wiki on troubleshooting and debugging - Following the instructions in the Wiki on troubleshooting and debugging, i.e.:
- When done testing, `exit` the container -- `cd /var/www/site/public`
-- `php mailGraph.test test`
- When done testing, `exit` the container.
## Periodic cleanup of images and logs ## ## Periodic cleanup of images and logs ##
The following command must be run on a regular basis to clean up images and logs (add to cron for example): The following command must be run on a regular basis to clean up images and logs (add to cron for example):