HermetiqDocsOpen dashboard
Getting started
Getting started

Get your first build into Hermetiq

Create a project, apply the project-specific configuration from Quickstart, run Bazel, and verify that your build data arrived.

Typical path: account → Quickstart → first build

Prerequisites

Before connecting a build, you need:

  • A Bazel workspace you can run locally or in CI.
  • A Hermetiq account and access to a project.
  • Permission to add a credential helper and Bazel configuration to the workspace or CI environment.

1. Create an account and project

Create your account, then open Quickstart for the project that should receive the build. Project IDs are part of ingestion and authentication, so make sure you configure the intended project.

Create or open your account →

2. Configure your build

Use the project’s Quickstart page to download the credential helper and copy the generated .bazelrc configuration. Quickstart supplies your project ID, BEP endpoint, results URL, credential-helper hosts, and optional remote-cache values.

By default, Quickstart can isolate Hermetiq flags in a named Bazel configuration. This keeps them from applying to every build command until explicitly selected.

3. Run your first build

If you kept the default isolated configuration, activate it with --config=hermetiq:

Terminal
bazel build //... --config=hermetiq

If you chose global build entries instead, run your normal Bazel command. CI can use the same configuration once the credential helper is available in that environment.

4. Verify the data

  1. Open Build History in the Hermetiq dashboard.
  2. Confirm the invocation appears under the expected project.
  3. Open the build to inspect targets, actions, logs, cache, profile, or remote-execution data available for that invocation.