Get Started
Download. Run. Done.
Download ICDB, bring up your first threat graph, and optionally join a consortium.
Download ICDB
One static binary per platform. Latest release: v0.222.0
| Platform | Architecture | File | SHA-256 |
|---|---|---|---|
| Linux | x86_64 | icdb-linux-amd64.tar.xz | |
| Linux | arm64 | icdb-linux-arm64.tar.xz | |
| macOS | Apple Silicon | icdb-darwin-arm64.tar.xz | |
| Windows | x86_64 | icdb-windows-amd64.zip |
Verify each download with sha256sum -c against the hash above.
Each release also ships a signed release.Manifest at
releases.ic.pid4.io/v0.222.0/manifest.json
(Ed25519); icdb update
verifies it automatically before swapping the binary, so once you've
installed any ICDB v0.32+ build a single icdb update keeps
you on the latest signed release with no further verification step
required.
Four steps to your first graph
- Download the binary for your platformPick the build above. The archive contains a single static binary: no runtime dependencies, no installer.
- Extract and run
tar xJf icdb-*.tar.xz && ./icdb serve --admin-email=you@example.comstarts a single-user instance onhttp://localhost:8181with on-disk SQLite (ic.dbin the working directory) so your data survives restarts. No database server, no broker, just one flag. - Sign inFirst boot prints an ICDB ready — first boot banner with an
Emailand aPasswordrow. Sign in athttp://localhost:8181with the email you passed to--admin-email(not a username) and the generated password. Copy it before the log scrolls — it is shown once. Pass-p <yours>if you’d rather pick the password yourself, or run./icdb reset-admin --admin-email you@example.comlater to generate a new one. - Create your first threat graphOpen the Threat Graph page in the UI (
http://localhost:8181/threat-graph/) to spin up your first graph. This is where you’ll model adversaries, infrastructure, and the relationships between them, and where every later workflow (ingest, ICQL queries, dashboards) anchors. - Bonus: Explore consortiumsVisit Settings → Consortium to browse public groups. The open pid4 consortium is free to join and is a good first taste of shared threat intel. If a peer has already sent you a private invite token, redeem it on the same page. Everything you share through any consortium is end-to-end encrypted and signed for third-party-verifiable attribution.
Team mode: Docker Compose
More than two or three people sharing one install, or you want Postgres-grade backups? Pull the canonical compose file and bring up the same ICDB binary with managed PostgreSQL and persistent identity-key + error-log volumes.
curl -O https://pid4.io/ic/customer-compose.ymlThe header comment ships the .env template and the backup snippets inline — full walk-through in
From Laptop to Production.