Create an Organization
Use this article to create your OX account and set up your organization. If you already received an invitation email, skip this article and see Accept an invitation instead.
Create your OX account and organization
To create your account and organization:
Go to https://app.ox.security/ and click Login.
In the dialog, click Sign up.
Select how you want to create your account:
Google
GitHub
Email and password
Enter an email address.
Create a password that meets the requirements.
Verify your email using the link we send you.
OX creates your organization and prompts you to connect your repositories.
You can rename the organization now or later in Settings.
Choose how you want to get started:
Load demo data to explore OX without connecting your own repositories.
Connect your repositories to start scanning immediately.
Load demo data
To load demo data:
From the dialog, click Alternatively try the OX Demo.
OX loads and scans demo repositories and opens your Dashboard.
Connect your repositories
Follow the steps in the dialog to connect repositories from GitHub, GitLab, Bitbucket, or Azure Repos. If your source control system doesn’t appear in the dialog, close it and go to Connectors to select another platform.
At a glance: Create an OX account and an organization, then explore how we can secure your software supply chain. You can use our demo data to get acquainted, or you can jump right in and connect your own repositories.
Overview
If you're trying out OX on your own or if you're the person setting up OX for your company, follow these steps to get connected:
1: Create your OX account and organization
To create an OX account and organization:
Go to https://app.ox.security/ and click the Login button at the top-right corner of the screen.
In the dialog, click Sign up.\

From the Create your account dialog, select the method you want to use to create your account:
Google (requires an existing Google account)
GitHub (requires an existing GitHub account)
Note: Choosing this option does not connect your GitHub repositories to OX.
Email address and password
Enter an email address where you can receive mail.
Create a password that meets the requirements displayed in the dialog.
Click Continue.
Check your email inbox for a verification email. Click the link in the email.
OX creates your organization and prompts you to connect a code repository.
If you want to change the organization name, you can do it here. Or you can change it later from the Settings page.
Follow the instructions in section 2a or 2b, below:
2a: Load demo data
To load the demo data:
From the dialog, click the Alternatively try the OX Demo link.\

OX loads and scans the demo data and opens the Dashboard (this takes a minute or two).
Congratulations! You're ready to start exploring OX using the demo data.
2b: Connect your repositories

If your repositories are located on a source control platform other than the 4 available in this dialog:
Click X to close the dialog.
In the Choose your environment setup dialog that appears, click Connect manually.
The Connectors page will open, allowing you to select your source control platform from all the available OX-supported options.
To connect your repositories, follow the instructions in the tab below for your source control platform:
There are 3 authorization options available for GitHub:
OX GitHub app (default)
GitHub identity provider
GitHub access token
To select an option and connect:
Click the
button.
The Connect button and the Other authorization options dropdown are now available.Select your authorization option:
To use the OX GitHub app (the default option), click Connect and follow the prompts.
To use the GitHub identity provider:
Click the arrow to open the Other authorization options dropdown.
Select Use git identity provider and follow the prompts to sign in and authorize OX.
To use a GitHub access token:
Click the arrow to open the Other authorization options dropdown.
Select Use git access token.
Enter the git host URL. Note: By default, OX enters the GitHub SaaS URL (https://api.github.com). If you use a self-hosted git installation (GitHub Enterprise Server), replace it with your local git URL.
Follow the displayed instructions for generating a GitHub access token and paste it into the Token field.
Click Connect.
From the displayed list, select the repositories you want OX to monitor and protect.
By default, all detected repositories are selected. You can check/uncheck options according to your preference.
Check the Monitor all newly created repos option if you want OX to begin monitoring any future repos automatically upon their creation.
Click Continue.
OX starts a scan of the selected repos and opens the Dashboard.
Congratulations! You're ready to start using OX.
Note: If you have repositories on other source control platforms, you can connect them anytime from the Connectors page.
There are 2 authorization options available for GitLab:
GitLab identity provider (default)
GitLab access token
To select an option and connect:
Click the
button.
The Connect button and the Other authorization options dropdown are now available.Select your authorization option:
To use the GitLab identity provider (the default option), click Connect and follow the prompts to sign in and authorize OX.
To use a GitLab access token:
Click the arrow to open the Other authorization options dropdown.
Select Use git access token.
Enter the git host URL. Note: By default, OX enters the GitLab SaaS URL (https://gitlab.com). If you use a self-hosted git installation (GitLab Self-Managed), replace it with your local git URL.
Follow the displayed instructions for generating a GitLab access token and paste it into the Token field.
Click Connect.
From the displayed list, select the repositories you want OX to monitor and protect.
By default, all detected repositories are selected. You can check/uncheck options according to your preference.
Check the Monitor all newly created repos option if you want OX to begin monitoring any future repos automatically upon their creation.
Click Continue.
OX starts a scan of the selected repos and opens the Dashboard.
Congratulations! You're ready to start using OX.
Note: If you have repositories on other source control platforms, you can connect them anytime from the Connectors page.
There are 3 authorization options available for Bitbucket Cloud:
OX Bitbucket app (default)
Bitbucket identity provider
Bitbucket access token
To select an option and connect:
Click the
button.
The Connect button and the Other authorization options dropdown are now available.Select your authorization option:
To use the OX Bitbucket app (the default option), click Connect and follow the prompts.
To use the Bitbucket identity provider:
Click the arrow to open the Other authorization options dropdown.
Select Use git identity provider and follow the prompts to sign in and authorize OX.
To use a Bitbucket access token:
Click the arrow to open the Other authorization options dropdown.
Select Use git access token.
The Bitbucket Cloud URL (https://api.bitbucket.org/2.0) is automatically filled in. If you use an on-prem installation (Bitbucket Data Center or Bitbucket Server), do not connect from this screen. Instead, connect from the Connectors page.
Follow the displayed instructions for generating an app password and paste the generated username and password into the Token field.
Click Connect.
From the displayed list, select the repositories you want OX to monitor and protect.
By default, all detected repositories are selected. You can check/uncheck options according to your preference.
Check the Monitor all newly created repos option if you want OX to begin monitoring any future repos automatically upon their creation.
Click Continue.
OX starts a scan of the selected repos and opens the Dashboard.
Congratulations! You're ready to start using OX.
Note: If you have repositories on other source control platforms, you can connect them anytime from the Connectors page.
There are 2 authorization options available for Azure Repos:
Azure identity provider (default)
Azure access token
To select an option and connect:
Click the
button.
The Connect button and the Other authorization options dropdown are now available.Select your authorization option:
To use the Azure identity provider (the default option), click Connect and follow the prompts to sign in and authorize OX.
To use an Azure access token:
Click the arrow to open the Other authorization options dropdown.
Select Use git access token.
The Azure SaaS URL (https://dev.azure.com/) is automatically filled in. If you use an on-prem installation (Azure DevOps Server), do not connect from this screen. Instead, connect from the Connectors page.
Follow the displayed instructions for generating an Azure access token and paste it into the Token field.
Click Connect.
From the displayed list, select the repositories you want OX to monitor and protect.
By default, all detected repositories are selected. You can check/uncheck options according to your preference.
Check the Monitor all newly created repos option if you want OX to begin monitoring any future repos automatically upon their creation.
Click Continue.
OX starts a scan of the selected repos and opens the Dashboard.
Congratulations! You're ready to start using OX.
Note: If you have repositories on other source control platforms, you can connect them anytime from the Connectors page.
Last updated
