> [!WARNING]
> This project is under active development, the code in the main branch should
> be relatively stable but things might break every now and then. The releases
> that can be installed with `pip` are currently stable enough for testing. If
> you run into unexpected bugs, please create an
> [issue](https://github.com/retigra/ZabbixCI/issues/new). For questions about
> usage, please start a
> [discussion](https://github.com/retigra/ZabbixCI/discussions/new?category=q-a).
# ZabbixCI
ZabbixCI is a tool that adds continuous integration to Zabbix, allowing you to
synchronize Zabbix assets with a Git repository. By using the Zabbix API,
ZabbixCI can create, update, and delete assets across multiple Zabbix servers.
> [!NOTE]
> ZabbixCI has no affiliation with [Zabbix SIA](https://www.zabbix.com).
## Features
ZabbixCI provides the following features:
- Easily installable through pip or run it as a container image
- Fully configurable through cli arguments, config file and/or environment
variables
- Supports HTTP(S) and SSH auth for Git
- Export assets from Zabbix and push them to Git
- Pull assets from Git and import them in Zabbix
- Only changed or new assets will be processed during Git push or Zabbix import
actions
- Removes deleted assets automatically (unless black- or whitelisting is used)
- Use dry-run to verify behavior without changes to Zabbix or Git
- Build with parallelization in mind to speed up the process (can be scaled for
your needs)
- (Optional) Support for private CA servers to verify certificates
- (Optional) Allow black-/whitelisting of assets (supports regexp)
- (Optional) Use separate branches for push and pull transactions
### Additional template features
- Sync your templates with Git
- Built-in Zabbix version compatibility checking
- (Optional) Automatically populate empty vendor field with your own string
- (Optional) Allow automatic versioning of exported templates based on
timestamps
### Additional image (icons and backgrounds) features
- Sync your map images with Git
- Sync your icon-maps with Git
- Dynamically generate icons and backgrounds in predefined sizes
- Use `.png` or `.svg` files as sources for image generation
## Installation
ZabbixCI is available on [PyPI](https://pypi.org/project/zabbixci/) and can be
installed using pip:
```bash
pip install zabbixci
```
Alternatively, you can use a container image to run ZabbixCI, see the available
[container images](https://github.com/retigra/ZabbixCI/pkgs/container/zabbixci).
See the
[Containerized Deployment](https://github.com/retigra/ZabbixCI/blob/main/docs/Containerized.md)
documentation for more information.
## Configuration
ZabbixCI requires parameters to be set as command line arguments, a yaml
configuration or as environment variables. See the
[example configuration file](https://github.com/retigra/ZabbixCI/tree/main/docs/config.yaml).
We recommend passing environment variables when using the container image. Feel
free to use the method that best suits your workflow.
## Usage
We have a
[quickstart tutorial](https://github.com/retigra/ZabbixCI/tree/main/docs/tutorials/quickstart.md)
for first time users. Please see the
[Docs](https://github.com/retigra/ZabbixCI/tree/main/docs/README.md) for
extended details if needed.
# License
This project is licensed under AGPL-3.0, see
[LICENSE](https://github.com/retigra/ZabbixCI/tree/main/LICENSE.txt) for more
information.
# Contributing
Contributions are welcome! Please take a look at the following guidelines:
- Commit messages should follow the [Gitmoji](https://gitmoji.dev/) convention
or prefix with types (feat:, fix:, style:, etc.).
- The codebase uses [ruff](https://docs.astral.sh/ruff/) for formatting and
linting.
## Star History
> [!NOTE]
> If you like this project, please consider starring it on GitHub. ❤️
<a href="https://star-history.com/#retigra/ZabbixCI&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=retigra/ZabbixCI&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=retigra/ZabbixCI&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=retigra/ZabbixCI&type=Date" />
</picture>
</a>
Raw data
{
"_id": null,
"home_page": null,
"name": "zabbixci",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": "Wouter de Bruijn <wouter.debruijn@retigra.nl>, Raymond Kuiper <raymond.kuiper@retigra.nl>",
"keywords": "zabbix, git, source control, templates",
"author": null,
"author_email": "Retigra <info@retigra.nl>",
"download_url": "https://files.pythonhosted.org/packages/06/74/ae2c2ab0b6f4284de334c1471eaf20237d40356e5f3a6199bffe42cba2ab/zabbixci-0.3.10.tar.gz",
"platform": null,
"description": "![ZabbixCI cog logo](https://raw.githubusercontent.com/retigra/zabbixci/main/logo.png \"ZabbixCI logo\")\n\n\n\n\n\n> [!WARNING]\n> This project is under active development, the code in the main branch should\n> be relatively stable but things might break every now and then. The releases\n> that can be installed with `pip` are currently stable enough for testing. If\n> you run into unexpected bugs, please create an\n> [issue](https://github.com/retigra/ZabbixCI/issues/new). For questions about\n> usage, please start a\n> [discussion](https://github.com/retigra/ZabbixCI/discussions/new?category=q-a).\n\n# ZabbixCI\n\nZabbixCI is a tool that adds continuous integration to Zabbix, allowing you to\nsynchronize Zabbix assets with a Git repository. By using the Zabbix API,\nZabbixCI can create, update, and delete assets across multiple Zabbix servers.\n\n> [!NOTE]\n> ZabbixCI has no affiliation with [Zabbix SIA](https://www.zabbix.com).\n\n## Features\n\nZabbixCI provides the following features:\n\n- Easily installable through pip or run it as a container image\n- Fully configurable through cli arguments, config file and/or environment\n variables\n- Supports HTTP(S) and SSH auth for Git\n- Export assets from Zabbix and push them to Git\n- Pull assets from Git and import them in Zabbix\n- Only changed or new assets will be processed during Git push or Zabbix import\n actions\n- Removes deleted assets automatically (unless black- or whitelisting is used)\n- Use dry-run to verify behavior without changes to Zabbix or Git\n- Build with parallelization in mind to speed up the process (can be scaled for\n your needs)\n- (Optional) Support for private CA servers to verify certificates\n- (Optional) Allow black-/whitelisting of assets (supports regexp)\n- (Optional) Use separate branches for push and pull transactions\n\n### Additional template features\n\n- Sync your templates with Git\n- Built-in Zabbix version compatibility checking\n- (Optional) Automatically populate empty vendor field with your own string\n- (Optional) Allow automatic versioning of exported templates based on\n timestamps\n\n### Additional image (icons and backgrounds) features\n\n- Sync your map images with Git\n- Sync your icon-maps with Git\n- Dynamically generate icons and backgrounds in predefined sizes\n- Use `.png` or `.svg` files as sources for image generation\n\n## Installation\n\nZabbixCI is available on [PyPI](https://pypi.org/project/zabbixci/) and can be\ninstalled using pip:\n\n```bash\npip install zabbixci\n```\n\nAlternatively, you can use a container image to run ZabbixCI, see the available\n[container images](https://github.com/retigra/ZabbixCI/pkgs/container/zabbixci).\nSee the\n[Containerized Deployment](https://github.com/retigra/ZabbixCI/blob/main/docs/Containerized.md)\ndocumentation for more information.\n\n## Configuration\n\nZabbixCI requires parameters to be set as command line arguments, a yaml\nconfiguration or as environment variables. See the\n[example configuration file](https://github.com/retigra/ZabbixCI/tree/main/docs/config.yaml).\n\nWe recommend passing environment variables when using the container image. Feel\nfree to use the method that best suits your workflow.\n\n## Usage\n\nWe have a\n[quickstart tutorial](https://github.com/retigra/ZabbixCI/tree/main/docs/tutorials/quickstart.md)\nfor first time users. Please see the\n[Docs](https://github.com/retigra/ZabbixCI/tree/main/docs/README.md) for\nextended details if needed.\n\n# License\n\nThis project is licensed under AGPL-3.0, see\n[LICENSE](https://github.com/retigra/ZabbixCI/tree/main/LICENSE.txt) for more\ninformation.\n\n# Contributing\n\nContributions are welcome! Please take a look at the following guidelines:\n\n- Commit messages should follow the [Gitmoji](https://gitmoji.dev/) convention\n or prefix with types (feat:, fix:, style:, etc.).\n- The codebase uses [ruff](https://docs.astral.sh/ruff/) for formatting and\n linting.\n\n## Star History\n\n> [!NOTE]\n> If you like this project, please consider starring it on GitHub. \u2764\ufe0f\n\n<a href=\"https://star-history.com/#retigra/ZabbixCI&Date\">\n <picture>\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=retigra/ZabbixCI&type=Date&theme=dark\" />\n <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=retigra/ZabbixCI&type=Date\" />\n <img alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=retigra/ZabbixCI&type=Date\" />\n </picture>\n</a>\n",
"bugtrack_url": null,
"license": null,
"summary": "Source control for Zabbix templates in Git",
"version": "0.3.10",
"project_urls": {
"Changelog": "https://github.com/retigra/zabbixci/releases",
"Discussions": "https://github.com/retigra/ZabbixCI/discussions",
"Homepage": "https://github.com/retigra/zabbixci",
"Issues": "https://github.com/retigra/zabbixci/issues",
"Repository": "https://github.com/retigra/zabbixci"
},
"split_keywords": [
"zabbix",
" git",
" source control",
" templates"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7dc78d803d529d402d24be4972d9da7dba2a3909310d41fc8a6e0e1df4283ebb",
"md5": "09e4e3898f03ed59c275510da08f87ba",
"sha256": "81e292f3ff18ab1cb647d6fc4112c868df7f28b24154e2a2212371f541b4de8a"
},
"downloads": -1,
"filename": "zabbixci-0.3.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "09e4e3898f03ed59c275510da08f87ba",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 50596,
"upload_time": "2025-07-22T11:26:24",
"upload_time_iso_8601": "2025-07-22T11:26:24.060019Z",
"url": "https://files.pythonhosted.org/packages/7d/c7/8d803d529d402d24be4972d9da7dba2a3909310d41fc8a6e0e1df4283ebb/zabbixci-0.3.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0674ae2c2ab0b6f4284de334c1471eaf20237d40356e5f3a6199bffe42cba2ab",
"md5": "443de9f3adc2d4d2a1fc4ca9c8287d3f",
"sha256": "5403ed35a5f584861423be5357f0f2f4b7ccc75ca9dcb4019965d64278a9358f"
},
"downloads": -1,
"filename": "zabbixci-0.3.10.tar.gz",
"has_sig": false,
"md5_digest": "443de9f3adc2d4d2a1fc4ca9c8287d3f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 265151,
"upload_time": "2025-07-22T11:26:25",
"upload_time_iso_8601": "2025-07-22T11:26:25.601648Z",
"url": "https://files.pythonhosted.org/packages/06/74/ae2c2ab0b6f4284de334c1471eaf20237d40356e5f3a6199bffe42cba2ab/zabbixci-0.3.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-22 11:26:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "retigra",
"github_project": "zabbixci",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "aiohappyeyeballs",
"specs": [
[
"==",
"2.6.1"
]
]
},
{
"name": "aiohttp",
"specs": [
[
"==",
"3.12.14"
]
]
},
{
"name": "aiosignal",
"specs": [
[
"==",
"1.4.0"
]
]
},
{
"name": "attrs",
"specs": [
[
"==",
"25.3.0"
]
]
},
{
"name": "cffi",
"specs": [
[
"==",
"1.17.1"
]
]
},
{
"name": "frozenlist",
"specs": [
[
"==",
"1.7.0"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.10"
]
]
},
{
"name": "multidict",
"specs": [
[
"==",
"6.6.3"
]
]
},
{
"name": "propcache",
"specs": [
[
"==",
"0.3.2"
]
]
},
{
"name": "pycparser",
"specs": [
[
"==",
"2.22"
]
]
},
{
"name": "pygit2",
"specs": [
[
"==",
"1.18.0"
]
]
},
{
"name": "regex",
"specs": [
[
"==",
"2024.11.6"
]
]
},
{
"name": "ruamel-yaml",
"specs": [
[
"==",
"0.18.14"
]
]
},
{
"name": "ruamel-yaml-clib",
"specs": [
[
"==",
"0.2.12"
]
]
},
{
"name": "wand",
"specs": [
[
"==",
"0.6.13"
]
]
},
{
"name": "yarl",
"specs": [
[
"==",
"1.20.1"
]
]
},
{
"name": "zabbix-utils",
"specs": [
[
"==",
"2.0.3"
]
]
}
],
"lcname": "zabbixci"
}
JSON
