> For the complete documentation index, see [llms.txt](https://docs.nullify.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nullify.ai/getting-started/install.md).

# Install

Start at [app.nullify.ai](https://app.nullify.ai/) and sign in with your work account. The address is `app.nullify.ai`, not `app.nullify.io`.

1. If you already belong to a workspace, sign-in opens it. Continue with onboarding or **Settings**.
2. If you see **Your Microsoft sign-in worked** and a note that your organization does not have a Nullify workspace yet, your Microsoft account is not linked to a workspace yet. That screen does not mean you missed a setup step, and **Request workspace** does not claim a workspace Nullify has already prepared. Wait for the setup invitation from your Nullify representative.
3. Open the invitation link. Enter the verification code sent to the approved work email, continue with the same Microsoft work account, and finish the checks on that page. A new Azure DevOps workspace follows [Set up a new workspace](https://docs.nullify.ai/getting-started/install/azure-install.md#set-up-a-new-workspace). You do not create an app registration or send Nullify a directory ID.
4. After activation, the onboarding wizard opens. Connect your source-control provider, select repositories, and complete [setup](https://docs.nullify.ai/getting-started/getting-started.md). Activating the workspace does not install Azure DevOps or start a scan.
5. If you see **Your workspace is being prepared**, the workspace exists but is awaiting provisioning. Your Nullify representative will reach out when it is ready; **Check workspace status** checks again.

Existing workspace members sign in and continue with their configured workspace. Contact your Nullify representative or <hello@nullify.ai> if the invitation expires or the verification email does not arrive.

{% hint style="info" %}
There is no `.nullify.yml` or other in-repo config file to add. Behaviour such as the CI/PR gate (fail-build, automated PR reviews), ticket-creation thresholds, SLA policies, finding allowlists, and notification targets is configured in the Nullify dashboard in **Settings** (or via the admin API), not by committing a file to your repository.
{% endhint %}
