Skip to main content

Install Infrahub Community

Infrahub Community is deployed as a container-based architecture and can be installed using several methods.

Before you install, review the hardware requirements, including the local development and evaluation sizing.

Using curl and Docker Compose​

To quickly spin up the latest Infrahub locally, retrieve the Docker Compose file from infrahub.opsmill.io.

You can also specify a specific version or the develop branch in the URL:

Prerequisites​

Start an Infrahub environment​

curl https://infrahub.opsmill.io > docker-compose.yml
docker compose -p infrahub up -d

After running the command, you should see Docker downloading the necessary images and starting the containers.

success

Verify that Infrahub is running by accessing the web interface or checking container status:

docker ps | grep infrahub

Observability (optional)​

To also deploy the observability stack (Grafana, Prometheus, Loki, Tempo, Alloy), fetch the compose file with ?observability=true: curl "https://infrahub.opsmill.io/?observability=true" > docker-compose.yml. See Observability stack.

Stop and remove an Infrahub environment​

curl https://infrahub.opsmill.io > docker-compose.yml
docker compose -p infrahub down -v

Log in​

Infrahub creates an administrator account the first time it starts with an empty database. Open the web interface, select Log in in the bottom-left corner, and enter the default credentials:

Default credentials
  • Username: admin
  • Password: infrahub

With Docker Compose or a clone of the repository, the web interface is at http://localhost:8000. With Helm, use the address of the ingress or service that exposes the Infrahub API server.

To start with a different password, set INFRAHUB_INITIAL_ADMIN_PASSWORD before the first start. Infrahub reads this variable only when it creates the account, so changing it later has no effect. After the first start, change the password from the account menu in the bottom-left corner: select Account settings, then the Password tab.

For a production deployment, replace this password and the other default values listed in Production deployment.

Load a schema​

Infrahub ships with a minimal built-in schema. After installation, load a domain schema to model your infrastructure.

Use the Marketplace for pre-built schemas

The Infrahub Marketplace hosts ready-to-use schemas for common domains such as DCIM, IPAM, locations, and routing. Fetch a schema with infrahubctl marketplace get infrahub/dcim, then load it with infrahubctl schema load schemas/dcim.yml. See Infrahub Marketplace for the complete workflow.