{"id":13629375,"url":"https://github.com/somsakc/docker-observium","last_synced_at":"2025-04-17T09:33:29.151Z","repository":{"id":45798596,"uuid":"80593946","full_name":"somsakc/docker-observium","owner":"somsakc","description":"Docker container for Observium Community Edition","archived":false,"fork":false,"pushed_at":"2025-02-15T10:41:21.000Z","size":49,"stargazers_count":83,"open_issues_count":6,"forks_count":56,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-02-15T11:28:46.906Z","etag":null,"topics":["docker","docker-compose","docker-container","docker-image","observium","observium-container"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/somsakc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-01T06:01:54.000Z","updated_at":"2025-02-15T10:41:25.000Z","dependencies_parsed_at":"2024-01-14T04:30:11.655Z","dependency_job_id":"772b138d-0e68-4a6d-99f9-5bb28e2dc43d","html_url":"https://github.com/somsakc/docker-observium","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somsakc%2Fdocker-observium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somsakc%2Fdocker-observium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somsakc%2Fdocker-observium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somsakc%2Fdocker-observium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/somsakc","download_url":"https://codeload.github.com/somsakc/docker-observium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249331627,"owners_count":21252619,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","docker-container","docker-image","observium","observium-container"],"created_at":"2024-08-01T22:01:08.822Z","updated_at":"2025-04-17T09:33:29.128Z","avatar_url":"https://github.com/somsakc.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile"],"sub_categories":[],"readme":"# Docker Container for Observium Community Edition\nObservium is network monitoring with intuition. It is a low-maintenance auto-discovering network monitoring platform supporting a wide range of device types, platforms and operating systems including Cisco, Windows, Linux, HP, Juniper, Dell, FreeBSD, Brocade, Netscaler, NetApp and many more. Observium focuses on providing a beautiful and powerful yet simple and intuitive interface to the health and status of your network. For more information, go to http://www.observium.org site.\n\nAvailable platforms are:\n* AMD64 (Intel x86_64) https://hub.docker.com/r/mbixtech/observium/\n* ARM32v7 (Raspberri Pi 2/3) https://hub.docker.com/r/mbixtech/arm32v7-observium/\n\n## Build Image\n### For amd64 Architecture\n```sh\n   $ cd amd64\n   $ docker build -t mbixtech/observium:latest .\n```\n- To build a specific version, add `--build-arg FETCH_VERSION=24.12`.\n\n### For arm32v7 Architecture\n```sh\n  $ cd arm32v7\n  $ docker build -t mbixtech/arm32v7-observium:latest .\n```\n\n## Launch Observium\nEither follow the choice A. or B. below to run Observium.\n\n### A. Manual Run Containers\n- Prepare working directory for docker containers, for example below.\n```sh\n  $ mkdir -p /home/docker/observium/{data,logs,rrd}\n```\n- Run official MariaDB container\n```sh\n  $ docker run --name observiumdb \\\n    -v /home/docker/observium/data:/var/lib/mysql \\\n    -e MYSQL_ROOT_PASSWORD=passw0rd \\\n    -e MYSQL_USER=observium \\\n    -e MYSQL_PASSWORD=passw0rd \\\n    -e MYSQL_DATABASE=observium \\\n    -e TZ=$(cat /etc/timezone) \\\n    mariadb\n```\n\n- Run this Observium container\n```sh\n  $ docker run --name observiumapp --link observiumdb:observiumdb \\\n    -v /home/docker/observium/logs:/opt/observium/logs \\\n    -v /home/docker/observium/rrd:/opt/observium/rrd \\\n    -e OBSERVIUM_ADMIN_USER=admin \\\n    -e OBSERVIUM_ADMIN_PASS=passw0rd \\\n    -e OBSERVIUM_DB_HOST=observiumdb \\\n    -e OBSERVIUM_DB_USER=observium \\\n    -e OBSERVIUM_DB_PASS=passw0rd \\\n    -e OBSERVIUM_DB_NAME=observium \\\n    -e OBSERVIUM_BASE_URL=http://yourserver.yourdomain:8080 \\\n    -e TZ=$(cat /etc/timezone) \\\n    -p 8080:80\n    mbixtech/observium:latest\n```\n\n\u003e Note:\n\u003e - You must replace passwords specified in environment parameters of both containers with your secure passwords instead.\n\u003e - Requires a linked MySQL or MariaDB container (ex.: `--link observiumdb:observiumdb`).\n\u003e - `OBSERVIUM_BASE_URL` supports AMD64 container only (plan to support ARM32v7 soon).\n\n### B. Use Docker Compose\n- Follow instuctions below to create extra working directory of docker containers (You can change `/home/docker` directory to your desired directory).\n```sh\n  $ cd /home/docker\n  $ git clone https://github.com/somsakc/docker-observium.git observium\n  $ cd observium\n  $ mkdir data logs mysql\n```\n\u003e Note: You do not need to clone whole git repository. You can download `docker-compose.yml` file and `.env` file file. Then, place both files into e.g. `/home/docker/observium` directory mentioned above.\n\n- Change some environments to your appropreate values in `docker-compose.yml` file, e.g. `OBSERVIUM_ADMIN_USER`, `OBSERVIUM_ADMIN_PASS`.\n\n- Force pulling the latest Observium image from docker hub web site. It is to ensure that you will get the latest one.\n```sh\n  $ docker compose pull\n```\n\n- Run both database and Observium containers.\n```sh\n  $ docker compose up\n```\n\n- For your first time, you may add a new device, discover and poll that device. It is given an idea below (I follow https://docs.observium.org/install_debian/#perform-initial-discovery-and-poll).\n```sh\n  $ docker compose exec app /opt/observium/add_device.php \u003chostname\u003e \u003ccommunity\u003e v2c\n  $ docker compose exec app /opt/observium/discovery.php -h all\n  $ docker compose exec app /opt/observium/poller.php -h all\n```\n\n## Changes\n- [2025-02-15] Merge pull request [#36](https://github.com/somsakc/docker-observium/pull/36) into master branch\n  - Upgraded base image to Ubuntu 24.04 (amd64/Dockerfile)\n  - Supports running latest Observium 24.12 (amd64/Dockerfile)\n  - Update docker-compose.yml for recommended best practices\n  - Update README.md with build image instructions\n- [2024-01-15] Merge pull request [#35](https://github.com/somsakc/docker-observium/pull/35) into master branch\n  - Fixed TZ parameter in observium-init.sh file\n- [2024-01-14] Merge pull request [#34](https://github.com/somsakc/docker-observium/pull/34) into master branch\n  - Upgraded base image from Ubuntu 20.04 to 22.04 (amd64/Dockerfile)\n  - Upgraded related packages (e.g. php) to match Ubuntu 22.04 and enhanced build code (amd64/Dockerfile)\n  - Revised observium-init.sh file and supported upgarding container to higher Observium version (run \"discovery.php -u\" whenever container starts)\n  - Fixed warning message caused by supervisord.conf file\n- [2024-01-01] Built docker image with Observium CE 23.9.13005 on AMD64 platform only\n  - Merged pull request [#28](https://github.com/somsakc/docker-observium/pull/28) into master branch\n  - Revised amd64/observium-init.sh file by updating /etc/timezone and /etc/localtime in container image whenever TZ environment is specified. It will effect to rrd graph.\n  - Revised amd64/observium-init.sh file by using MYSQL_PWD variable with mysql command instead\n  - Revised amd64/Dockerfile file to remove mysql-server package\n- [2022-07-17] Built docker image with Observium CE 22.5.12042 on AMD64 platform only\n  - Fixed logrotate missing in amd64/Dockerfile\n  - Added libphp-phpmailer package in amd64/Dockerfile\n- [2021-11-01] Built docker image with Observium CE 21.10.11666 on AMD64 platform only\n  - Added monitoring-plugins-basic, monitoring-plugins-common and monitoring-plugins-standard packages\n- [2021-08-26] Built docker image with Observium CE 20.9.10731 on AMD64 platform only\n  - Upgraded base image to ubuntu:20.04\n  - Upgraded package to higher version with following Observium installation document, e.g. php-7.4\n  - Revised docker-compose.yml file and add .env file for specific project name (see source repository below)\n- [2020-02-16] Enhanced docker image with Observium CE 19.8.10000\n  - Revised initial/kickstart script for first time of container running with more information about database initialization.\n  - Moved Apache http access and error logs to /opt/observium/logs directory.\n  - Added logs of all cron jobs storing in /opt/observium/logs directory. \n  - Added logrotate for rotating logs in /opt/observium/logs directory.\n  - Chnaged working directory of container image to /opt/observium for ease of managing Observium inside.\n  - Fixed invalid cron parameter specified in supervisord.conf.\n  - Revised Dockerfile file.\n- [2018-10-28] Added 'Feature request: OBSERVIUM_BASE_URL #3' feature.\n- [2017-08-19] Corrected error of \"DB Error 1044: Access denied for user 'observium'@'%' to database 'observium'\" by replacing MYSQL_DB_NAME environment variable of database container with MYSQL_DATABASE instead (regarding environment definition changed by official mariadb image).\n- [2017-08-19] Add Observium image available on Raspberri Pi 2/3 (arm32v7) platform.\n\n## Source Repository\nSee source of project at https://github.com/somsakc/observium\n\n## TODOs\nI have a lot of plan to enhance this project. However, my work is priority to focus first. I hope I will have more time to do it.\n- Enhance more on Kubernetes platform, for both AMD64 and ARM64 (Pi).\n- Enhance more with secure TLS to Observium GUI.\n- Secure more container image.\n- Integrate rsyslog [2022/Q3]\n\n## Credits\n- Official Observium web site [https://www.observium.org]\n- Ubuntu installation from Observium web site [https://docs.observium.org/install_debian/]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomsakc%2Fdocker-observium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsomsakc%2Fdocker-observium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomsakc%2Fdocker-observium/lists"}