Skip to main content

Onboarding Your Organization

This guide is for tenant administrators setting up Null Autos for their organization for the first time. It covers connecting your source control, provisioning the integrations the platform needs, and inviting your team.

Overview​

Onboarding connects your tenant to your GitLab environment and stands up the supporting integrations so your developers can build, test, and run emulators.

The portal provides a guided onboarding flow that walks through these steps. The sections below explain what each one does.

1. Sign in​

Sign in to the portal with your administrator account. If your tenant was just created, your platform contact will provide initial admin credentials, which you should change immediately.

2. Connect a VCS provider​

Null Autos integrates with GitLab, both SaaS and self-managed. Add a VCS provider for your GitLab instance. This is how the platform reaches your repositories and CI.

3. Authorize access​

Complete the authorization so the platform can act on your GitLab group on your behalf. You can review the callback URLs and connected groups and projects from the tenant management screens.

4. Run bootstrap​

Bootstrap provisions everything your tenant needs to run builds and workspaces. In one operation it:

  • mirrors the platform's build templates into your GitLab group,
  • copies the required container images into your group's registry,
  • sets the CI/CD variables your pipelines need,
  • registers a CI runner and a GitLab agent for your cluster, and
  • installs the supporting Helm charts (including workspaces support, if enabled).

You can run a dry run first to preview what will be created, then apply it. Progress is tracked as operations you can monitor in the portal. When a bootstrap operation completes, onboarding is complete.

5. Invite your team​

Generate invite links from the admin onboarding section and share them with your users. The link prompts each user to sign in and link their GitLab account. Organize users into groups and grant each group access to the emulators and snapshots it needs.

Check onboarding status​

At any point you can review your tenant's onboarding status:

  • in the portal's tenant management section, or
  • via the API: GET /api/v1/tenants/{id}/onboarding/status.

After onboarding​