{"id":20504042,"url":"https://github.com/icinga/docker-icinga2","last_synced_at":"2026-01-27T23:48:33.129Z","repository":{"id":41874640,"uuid":"259279653","full_name":"Icinga/docker-icinga2","owner":"Icinga","description":"Official Icinga 2 Docker images","archived":false,"fork":false,"pushed_at":"2025-02-25T10:22:01.000Z","size":118,"stargazers_count":69,"open_issues_count":20,"forks_count":31,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-03-05T01:16:56.120Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Icinga.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":"2020-04-27T10:23:51.000Z","updated_at":"2025-02-06T10:14:28.000Z","dependencies_parsed_at":"2023-02-11T01:40:21.321Z","dependency_job_id":"f3666284-94ef-47ae-8052-eb43cf91537b","html_url":"https://github.com/Icinga/docker-icinga2","commit_stats":{"total_commits":73,"total_committers":9,"mean_commits":8.11111111111111,"dds":"0.20547945205479456","last_synced_commit":"e947c88080aa63486786422c15e63306ab6dce63"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Fdocker-icinga2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Fdocker-icinga2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Fdocker-icinga2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Icinga%2Fdocker-icinga2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Icinga","download_url":"https://codeload.github.com/Icinga/docker-icinga2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242100931,"owners_count":20071823,"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":[],"created_at":"2024-11-15T19:35:54.436Z","updated_at":"2026-01-27T23:48:33.102Z","avatar_url":"https://github.com/Icinga.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Icinga 2 Docker image | (c) 2020 Icinga GmbH | GPLv2+ --\u003e\n\n# Icinga 2 - Docker image\n\nThis image integrates [Icinga 2] into your [Docker] environment.\n\n## Usage\n\n```bash\ndocker network create icinga\n\n# CA\ndocker run --rm \\\n\t-h icinga-master \\\n\t-v icinga-master:/data \\\n\t-e ICINGA_MASTER=1 \\\n\ticinga/icinga2 \\\n\tcat /var/lib/icinga2/certs/ca.crt \u003e icinga-ca.crt\n\n# Ticket\ndocker run --rm \\\n\t-h icinga-master \\\n\t-v icinga-master:/data \\\n\t-e ICINGA_MASTER=1 \\\n\ticinga/icinga2 \\\n\ticinga2 daemon -C\ndocker run --rm \\\n\t-h icinga-master \\\n\t-v icinga-master:/data \\\n\t-e ICINGA_MASTER=1 \\\n\ticinga/icinga2 \\\n\ticinga2 pki ticket --cn icinga-agent \u003e icinga-agent.ticket\n\n# Master\ndocker run --rm -d \\\n\t--network icinga \\\n\t--name icinga-master \\\n\t-h icinga-master \\\n\t-p 5665:5665 \\\n\t-v icinga-master:/data \\\n\t-e ICINGA_MASTER=1 \\\n\ticinga/icinga2\n\n# Agent\ndocker run --rm -d \\\n\t--network icinga \\\n\t-h icinga-agent \\\n\t-v icinga-agent:/data \\\n\t-e ICINGA_ZONE=icinga-agent \\\n\t-e ICINGA_ENDPOINT=icinga-master,icinga-master,5665 \\\n\t-e ICINGA_CACERT=\"$(\u003c icinga-ca.crt)\" \\\n\t-e ICINGA_TICKET=\"$(\u003c icinga-agent.ticket)\" \\\n\ticinga/icinga2\n```\n\nThe container may listen on port 5665 and expects\na volume on `/data` and a specific persistent hostname.\nTo configure it, do one of the following:\n\n* Run the node wizard as usual. It will store all data in `/data`.\n  Hint: `docker run --rm -it -h icinga-master -v icinga-master:/data icinga/icinga2 icinga2 node wizard`\n* Provide configuration files, certificates, etc.\n  in `/data/etc/icinga2` and `/data/var/...` by yourself.\n  Consult the [Icinga 2 configuration documentation]\n  on which configuration files there are.\n* Provide environment variables as shown above.\n\nTo notify by e-mail, provide an [msmtp configuration] - either\nby mounting the `/etc/msmtprc` file or by specifying the desired content\nof `~icinga/.msmtprc` via the environment variable `MSMTPRC`.\n\n**Don't mount volumes under `/data/etc/icinga2` or `/data/var/*/icinga2`**\nunless `/data` already contains all of these directories!\nOtherwise `/data` will stay incomplete, i.e. broken.\n\n### Environment variables\n\nMost of the following variables correspond to\n`icinga2 node setup` CLI parameters.\nIf any of these is present and `icinga2 node setup`\nhas not been run yet, it will run.\nConsult the [node setup command documentation] on what are which parameters for.\n\nRegular variables:\n\n Variable                                                 | Node setup CLI\n ---------------------------------------------------------|--------------------\n `ICINGA_ACCEPT_COMMANDS=1`                               | `--accept-commands`\n `ICINGA_ACCEPT_CONFIG=1`                                 | `--accept-config`\n `ICINGA_DISABLE_CONFD=1`                                 | `--disable-confd`\n `ICINGA_MASTER=1`                                        | `--master`\n `ICINGA_CN=icinga-master`                                | `--cn icinga-master`\n `ICINGA_ENDPOINT=icinga-master,2001:db8::192.0.2.9,5665` | `--endpoint icinga-master,2001:db8::192.0.2.9,5665`\n `ICINGA_GLOBAL_ZONES=global-config`                      | `--global_zones global-config`\n `ICINGA_LISTEN=::,5665`                                  | `--listen ::,5665`\n `ICINGA_PARENT_HOST=2001:db8::192.0.2.9,5665`            | `--parent_host 2001:db8::192.0.2.9,5665`\n `ICINGA_PARENT_ZONE=master`                              | `--parent_zone master`\n `ICINGA_TICKET=0123456789abcdef0123456789abcdef01234567` | `--ticket 0123456789abcdef0123456789abcdef01234567`\n `ICINGA_ZONE=master`                                     | `--zone master`\n\nSpecial variables:\n\n* `ICINGA_TRUSTEDCERT`'s value is written to a temporary file\n  which is passed to `icinga2 node setup` via `--trustedcert`.\n* `ICINGA_CACERT`'s value is written to `/var/lib/icinga2/certs/ca.crt`.\n\n## Build it yourself\n\n```bash\ngit clone https://github.com/Icinga/icinga2.git\n#pushd icinga2\n#git checkout v2.12.0\n#popd\n\n./build.bash ./icinga2\n```\n\nIn order to run the script on macOS, [coreutils] must be installed:\n\n* Install [Homebrew]\n* Run `brew install coreutils`\n\n[Icinga 2]: https://github.com/Icinga/icinga2\n[Docker]: https://www.docker.com\n[Icinga 2 configuration documentation]: https://icinga.com/docs/icinga2/latest/doc/04-configuration/\n[msmtp configuration]: https://wiki.archlinux.org/index.php/Msmtp\n[node setup command documentation]: https://icinga.com/docs/icinga2/latest/doc/06-distributed-monitoring/#node-setup\n[Homebrew]: https://brew.sh/\n[coreutils]: https://formulae.brew.sh/formula/coreutils\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficinga%2Fdocker-icinga2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ficinga%2Fdocker-icinga2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficinga%2Fdocker-icinga2/lists"}