Data Observability platform Help

Getting started

Install SelectZero

SelectZero is a self-hosted application, deployed using:

The quick start below uses the Docker image. Whichever method you pick, read Prerequisites and Securing deployment for production first.

Quick start with Docker

Images are published on Docker Hub; the machine needs access to it.

  1. Pull the image

    docker pull selectzero/selectzero:2026.10.1
  2. Run the container

    docker run -d -v {local_path}/logs:/usr/app/logs -v {local_path}/database:/usr/app/database -v {local_path}/drivers:/usr/app/drivers -v {local_path}/reports:/usr/app/reports -v {local_path}/keys:/usr/app/keys -p 8090:8090 -e JAVA_OPTIONS='-XX:MaxRAMPercentage=50.0' selectzero/selectzero:2026.10.1

    The mounted folders keep the database, logs, drivers, reports and key files outside the container; what each one holds is explained in Deployment.

  3. Validate that the container is running

    docker ps

First login

By default, DQM will run on port 8090: http://localhost:8090

  • The initial password for the admin user is written to the file admin-init.txt in the application's working directory (/usr/app/admin-init.txt in the container — read it with e.g. docker exec <container> cat /usr/app/admin-init.txt). The application log points at this file. The file is deleted automatically after the first login:

    Username: admin Password: [generated password in admin-init.txt]

For more information, see configuration page.

Set up with the wizard

Until it is finished or put off with Do this later, every administrator login lands on the setup wizard, which connects the installation to your data in a few steps. Every step is optional, Next always moves on, and the wizard can be reopened at any time by visiting /settings/setup as an administrator. The step list on the left shows what is completed.

Setup wizard

  1. Change the password. Replace the generated administrator password with one of your own. This step is offered on the very first login only; later the password is changed under Settings → Profile.

  2. Add a license. Either paste the license key and activate it, after which the license details are shown, or choose Continue on the free tier. A key can be added later in Settings → General.

  3. Set up a connection. Pick the connector (grouped into databases, files, services and BI tools) and fill in the connection details; use a read-only database user.

    Connections Add

    A connector that still needs its JDBC driver JAR says so once it is picked: an administrator can upload the JAR right there and load it, after which the wizard comes back to this step with the connector selected. See Connector settings for the driver downloads. Saving creates the connection; if the connection test fails, the step stays open on the saved connection, says why, and the details can be corrected.

  4. Sync metadata. Choose the schemas to bring into the catalog and click Add and sync selected schemas. Every chosen schema appears in the table at once and shows whether it is queued, syncing, synced or failed; the wizard waits for each sync however long it takes.

    Once metadata is synced, Add a dbt project switches the dbt module on and opens the project dialog; the saved project is synced immediately. See dbt setup.

  5. Add users. Create accounts for colleagues one after the other with Add another user. See Users and roles.

  6. All set. The last page sums up what is in place (license, connections, synced objects, users, dbt) and lists what to do next, each with a link into the application and to the matching documentation.

Overview in data catalog

Objects page provides an overview of all database objects, allowing users to create a data catalog to manage data assets efficiently.

The Objects view can be accessed on the Catalog page under the Objects tab.

Catalog Objects

For every catalog object you can see for example its:

  • Quality - Data quality metric calculated based on test cases and profilings

  • Object - Object name in the database

  • Attributes - Number of attributes (columns) of the object

  • Test cases/Profilings - Counts of related validations

For more information, see Catalog page.

    Create data validations

    • Click "New test case" button and select "Empty test case" (the menu also offers Standard validations, the AI Assistant and Dynamic rules)

    • Fill test case info:

      Add query test case
      • Description - Test case short description, which will be visible from list view. A longer description can be added in the Additional information field

      • Expected result - Test case expected results, which can be either numerical or string value. Expected result can also be combination of two conditions:

        Expected result
      • Connection - Target connection to execute the test against, selected above the SQL editor

      • Query window - Test case SQL Query window on the SQL tab

    • Click "Save" button

      For more information, see test case page.

      Create profilings

      Profile Database Objects

      Follow these steps to profile database objects.

      1. Press "Add objects" button in the toolbar.

      2. Filter out objects you wish to profile.

        Profiling Objects
      3. Choose objects to profile by checking the checkboxes and clicking the "Add" button.

      4. New profiling object will now be shown on the page.

      For more information, see profiling page.

      22 October 2026