Quick install

Self-hosted Run DataGerry on your own machine in a few minutes with Docker Compose. This is the quickest path for evaluation and a sound basis for production. For packages (DEB, RPM, ZIP), TLS and production hardening, see Installing. To use DataGerry without installing anything, see Start in the cloud.

What you need

  • A Linux host with Docker Engine and the Compose plugin.

  • Port 80 free on the host.

  • Git.

Start DataGerry

The DataGerry-docker repository contains a Compose file with three containers — the DataGerry backend, MongoDB and an nginx frontend — and keeps all data in Docker volumes.

$ git clone https://github.com/DataGerry/DataGerry-docker.git /opt/DataGerry-docker
$ cd /opt/DataGerry-docker
$ cp conf/cmdb_default.conf conf/cmdb.conf
$ cp conf/app-config_default.json conf/app-config.json
$ cp conf/nginx_default.conf conf/nginx.conf
$ docker compose up -d

Open http://<host>/ in a browser and sign in:

User name

admin

Password

admin

Warning

Change the admin password straight away under Settings → Users (or the user menu), even on a test system.

If the page does not load, check the containers:

$ docker compose ps
$ docker logs dg-backend

Hint

Opening DataGerry from another machine? Set apiUrl in conf/app-config.json to the DNS name or IP address of the Docker host — with the default localhost the web interface only works in a browser on the host itself — and run docker compose restart. See app-config.json.

First steps

  • On the first sign-in the Start Assistant (Welcome to DATAGERRY) offers to create a ready-made set of types for your industry. Cancel it to start from scratch. See The Start Assistant.

  • Build your first type yourself: Your first CMDB.

  • The installation runs as Community Edition — the label next to the logo says so. To unlock IPAM, ISMS, the Document Generator, Automations or the REST API, activate a license: License Management.

  • Before you rely on it: set up backups and TLS.