{"id":26430771,"url":"https://github.com/bheisig/i-doit-docker","last_synced_at":"2025-07-16T15:36:57.824Z","repository":{"id":44522275,"uuid":"193913565","full_name":"bheisig/i-doit-docker","owner":"bheisig","description":"Dockerized i-doit CMDB","archived":false,"fork":false,"pushed_at":"2022-09-20T11:05:35.000Z","size":647,"stargazers_count":21,"open_issues_count":4,"forks_count":13,"subscribers_count":4,"default_branch":"main","last_synced_at":"2023-03-23T21:56:58.984Z","etag":null,"topics":["asset-management","cmdb","configuration-items","configuration-management","docker","docker-images","dockerfiles","docs","documentation","documentation-of-things","i-doit","idoit","it-asset-","it-assets","it-documentation","itam"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bheisig.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null}},"created_at":"2019-06-26T13:48:16.000Z","updated_at":"2022-12-22T09:37:02.000Z","dependencies_parsed_at":"2023-01-18T16:02:25.042Z","dependency_job_id":null,"html_url":"https://github.com/bheisig/i-doit-docker","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bheisig%2Fi-doit-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bheisig%2Fi-doit-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bheisig%2Fi-doit-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bheisig%2Fi-doit-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bheisig","download_url":"https://codeload.github.com/bheisig/i-doit-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244166362,"owners_count":20409165,"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":["asset-management","cmdb","configuration-items","configuration-management","docker","docker-images","dockerfiles","docs","documentation","documentation-of-things","i-doit","idoit","it-asset-","it-assets","it-documentation","itam"],"created_at":"2025-03-18T05:34:24.433Z","updated_at":"2025-03-18T05:34:25.059Z","avatar_url":"https://github.com/bheisig.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# i-doit Docker images\n\nDockerized [i-doit CMDB](https://i-doit.com/)\n\n[![Stars](https://img.shields.io/docker/stars/bheisig/idoit.svg)](https://hub.docker.com/r/bheisig/idoit/)\n[![Pulls](https://img.shields.io/docker/pulls/bheisig/idoit.svg)](https://hub.docker.com/r/bheisig/idoit/)\n[![Image size](https://img.shields.io/docker/image-size/bheisig/idoit?sort=date)](https://hub.docker.com/r/bheisig/idoit/)\n![Build status](https://github.com/i-doit/docs/actions/workflows/main.yml/badge.svg?branch=main)\n\n## Not production-ready!\n\n**The provided Docker images aren't production-ready. Please do not rely on them. They come \"as is\" with no warranty of any kind. They are not an official product by synetics GmbH. Because of this, we can't provide you any support.**\n\nAt the moment, we use these images for quality tests of i-doit and its add-ons. In the near-future we hope to provide you official i-doit Docker images which are well-tested and production-ready. In the meantime don't hesitate to test these images yourself. [We love to get your feedback!](https://github.com/bheisig/i-doit-docker/issues)\n\n## Supported tags and respective `Dockerfile` links\n\n-   `1.19-open-php8.0-fpm` ([`Dockerfile`](1.19/open/php8.0/fpm))\n-   `1.19-open-php8.0-apache` ([`Dockerfile`](1.19/open/php8.0/apache))\n-   `1.19-pro-php8.0-fpm` ([`Dockerfile`](1.19/pro/php8.0/fpm))\n-   `1.19-pro-php8.0-apache` ([`Dockerfile`](1.19/pro/php8.0/apache))\n-   `1.19-open-php7.4-fpm` ([`Dockerfile`](1.19/open/php7.4/fpm))\n-   `1.19-open-php7.4-apache` ([`Dockerfile`](1.19/open/php7.4/apache))\n-   `1.19-pro-php7.4-fpm` ([`Dockerfile`](1.19/pro/php7.4/fpm))\n-   `1.19-pro-php7.4-apache` ([`Dockerfile`](1.19/pro/php7.4/apache))\n-   `1.18.2-open-php7.4-fpm` ([`Dockerfile`](1.18.2/open/php7.4/fpm))\n-   `1.18.2-open-php7.4-apache` ([`Dockerfile`](1.18.2/open/php7.4/apache))\n-   `1.18.2-pro-php7.4-fpm` ([`Dockerfile`](1.18.2/pro/php7.4/fpm))\n-   `1.18.2-pro-php7.4-apache` ([`Dockerfile`](1.18.2/pro/php7.4/apache))\n-   `1.18.1-open-php7.4-fpm` ([`Dockerfile`](1.18.1/open/php7.4/fpm))\n-   `1.18.1-open-php7.4-apache` ([`Dockerfile`](1.18.1/open/php7.4/apache))\n-   `1.18.1-pro-php7.4-fpm` ([`Dockerfile`](1.18.1/pro/php7.4/fpm))\n-   `1.18.1-pro-php7.4-apache` ([`Dockerfile`](1.18.1/pro/php7.4/apache))\n-   `1.18-open-php7.4-fpm` ([`Dockerfile`](1.18/open/php7.4/fpm))\n-   `1.18-open-php7.4-apache` ([`Dockerfile`](1.18/open/php7.4/apache))\n-   `1.18-pro-php7.4-fpm` ([`Dockerfile`](1.18/pro/php7.4/fpm))\n-   `1.18-pro-php7.4-apache` ([`Dockerfile`](1.18/pro/php7.4/apache))\n\n**Note:** Older branches are not supported anymore but can still be found in the repository.\n\n## Quick reference\n\n-   **Where to get help**:\n    [`https://github.com/bheisig/i-doit-docker/issues`](https://github.com/bheisig/i-doit-docker/issues)\n-   **Where to file issues**:\n    [`https://github.com/bheisig/i-doit-docker/issues`](https://github.com/bheisig/i-doit-docker/issues)\n-   **Maintained by**:\n    [Benjamin Heisig](https://benjamin.heisig.name/)\n-   **Supported architectures**: x86_64\n-   **Source of this description**:\n    [`README.md`](https://github.com/bheisig/i-doit-docker/blob/master/README.md)\n-   **Supported Docker versions**:\n    [the latest release](https://github.com/docker/docker-ce/releases/latest) (down to 1.6 on a best-effort basis)\n\n## What is i-doit?\n\ni-doit (\"I document IT\") is a fully-featured Web application for CMDB (Configuration Management Databases), IT asset management (ITAM) and IT documentation. i-doit is maintained by the company synetics GmbH, located in Düsseldorf/Germany.\n\n## How to use this image\n\nEach image is built on the official PHP Docker image. We've got heavily inspired by the well-documented [Nextcloud docker image](https://github.com/nextcloud/docker). Thank you!\n\n### Run i-doit with PHP-FPM (recommended)\n\nRun the latest version of i-doit open with PHP 8.0 and FPM:\n\n~~~ {.bash}\ndocker run --name i-doit-fpm -p 9000:9000 bheisig/idoit:1.19-open-php8.0-fpm\n~~~\n\n### Run i-doit with Apache HTTPD (legacy)\n\nRun the latest version of i-doit open with PHP 8.0 and Apache HTTPD 2.4:\n\n~~~ {.bash}\ndocker run --name i-doit-apache -p 80:80 bheisig/idoit:1.19-open-php8.0-apache\n~~~\n\n### Available volumes\n\nEach i-doit container has one default volume containing the complete installation directory: `/var/www/html`. This directory includes the source code, cache files, uploaded files, installed add-ons, custom translation files, etc.\n\n### Run i-doit with Docker Compose\n\ni-doit requires either MariaDB or MySQL as the database backend. For better performance Memcached is highly recommended. There are some examples:\n\n-   [Run with PHP-FPM](docker-compose-fpm.yml) (preferred)\n-   [Run with PHP-FPM over UNIX sockets](docker-compose-sockets.yml) (even faster)\n-   [Run with Apache HTTPD](docker-compose-apache.yml) (legacy)\n\n### Run i-doit CLI tool\n\ni-doit has its own CLI tool named `console.php` for long-lasting, recurring tasks in background. You can call any CLI command in the running Docker container, for example:\n\n~~~ {.bash}\ndocker exec -it --user www-data i-doit-fpm php console.php --help\n~~~\n\n### Update i-doit\n\n_to be defined_\n\n### Backup and restore\n\nFor a complete backup and restore process you need to consider at least 3 sources:\n\n1.  i-doit installation directory (see section \"Available volumes\")\n2.  System database (default: `idoit_system`)\n3.  Each tenant database (default 1st one: `idoit_data`)\n\nAs you can see in the examples for `docker-compose` (see section \"Run i-doit with Docker Compose\") the simplest thing is to backup the named volumes. But for a running instance of MariaDB this is a bad solution because everything stored temporarily in memory won't be backed up. Run `mysqldump` (for backup) and `mysql` (for restore) to fetch every bit stored in the databases.\n\nThis is a basic example to backup everything in a running environment:\n\n~~~ {.bash}\ndocker exec i-doit-fpm /bin/tar cvf - . | gzip -9 \u003e backup.tar.gz\ndocker exec i-doit-fpm /usr/bin/mysqldump -uidoit -pidoit --all-databases | gzip -9 \u003e backup.sql.gz\n~~~\n\nThis is a basic example to restore those backups:\n\n~~~ {.bash}\ncat backup.tar.gz | docker exec --interactive --user www-data i-doit-fpm /bin/tar xzvf -\ngunzip \u003c backup.sql.gz | docker exec --interactive i-doit-fpm /usr/bin/mysql -uidoit -pidoit\n~~~\n\nDon't forget to alter the commands above to your needs.\n\n### Add a subscription license\n\nCopy the file to the running i-doit container and import the file with the i-doit CLI tool:\n\n~~~ {.bash}\ndocker cp license.txt i-doit-fpm:/tmp/\ndocker exec --interactive --user www-data i-doit-fpm php \\\n    console.php license-add \\\n    --user admin --password admin --no-interaction --license /tmp/license.txt\n~~~\n\n### Move your CMDB data to a container\n\nThe next example assumes that i-doit is installed on the same host as the running i-doit container:\n\n~~~ {.bash}\ncd /var/www/html/\ntar czvf - . | docker exec --interactive --user www-data i-doit-fpm /bin/tar xzvf -\nmysqldump -uidoit -pidoit --all-databases | \\\n    docker exec --interactive i-doit-fpm /usr/bin/mysql -uidoit -pidoit\n~~~\n\n### TLS/HTTPS\n\nWe _strongly_ recommend to access i-doit in a productive environment via TLS/HTTPS. Consider to use a load balancer or reverse proxy because the provided images are unable to handle TLS/HTTPS connections themselves.\n\n## Image variants\n\n`\u003cversion\u003e-\u003cedition\u003e-\u003cphp\u003e-\u003cservice\u003e`\n\n-   `\u003cversion\u003e`: Which version of i-doit do you like to run?\n-   `\u003cedition\u003e`: Which edition of i-doit do you like to run? Select `open` for community edition (Free Software) and `pro` for professional edition (proprietary).\n-   `\u003cphp\u003e`: Which version of [PHP](https://php.net/) do you like to run?\n-   `\u003cservice\u003e`: Decide to run i-doit either with [Apache HTTPD](https://httpd.apache.org/) or [PHP-FPM](https://php-fpm.org/)\n\n## Copyright \u0026 license\n\nCopyright (C) 2019-2022 [synetics GmbH](https://i-doit.com/)\n\nLicensed under the [GNU Affero GPL version 3 or later (`AGPLv3+`)](https://gnu.org/licenses/agpl.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbheisig%2Fi-doit-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbheisig%2Fi-doit-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbheisig%2Fi-doit-docker/lists"}