> ## Documentation Index
> Fetch the complete documentation index at: https://ona.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create or join an organization

When signing in for the first time, Ona prompts you to create a new organization. You'll automatically be the admin.

Organizations are the top-level boundary for people, projects, runners, policies, and secrets. Most teams have one organization per company or engineering group, though you can belong to more than one.

## Create an organization

1. Enter an organization name (can be changed later in Settings)
2. Optionally enable "Anyone with a *yourdomain.org* domain can join" to allow users with matching email domains to join automatically

<img src="https://mintcdn.com/gitpod-13c83c2b/p3fxpb4g8LzRcRvi/images/docs/flex/organizations/create-organization.webp?fit=max&auto=format&n=p3fxpb4g8LzRcRvi&q=85&s=7437922cc65d11f79eb32b15b7c5a01f" alt="Organization creation form with name field and domain join option" width="1494" height="1322" data-path="images/docs/flex/organizations/create-organization.webp" />

## Join an organization

If organizations exist that allow you to join (via domain matching), you'll see them listed. Click **Join** to become a member.

<img src="https://mintcdn.com/gitpod-13c83c2b/puCxqR1b6FB7kwaz/images/docs/flex/organizations/join-organization.webp?fit=max&auto=format&n=puCxqR1b6FB7kwaz&q=85&s=764f3c1b700c0713567d320fd1483d38" alt="Organization selection page showing available organizations to join" width="1619" height="1320" data-path="images/docs/flex/organizations/join-organization.webp" />

### From an invite link

Clicking an invite link takes you directly to the join page for that organization.

<img src="https://mintcdn.com/gitpod-13c83c2b/p3fxpb4g8LzRcRvi/images/docs/flex/organizations/join-organization-invite.webp?fit=max&auto=format&n=p3fxpb4g8LzRcRvi&q=85&s=0b6e12591b9d1486259a84c13a27f147" alt="Join confirmation page from an organization invite link" width="1410" height="1056" data-path="images/docs/flex/organizations/join-organization-invite.webp" />

### From the menu

You can access the join/create dialog anytime from the account dropdown menu.

<img src="https://mintcdn.com/gitpod-13c83c2b/puCxqR1b6FB7kwaz/images/docs/flex/organizations/join-organization-menu.webp?fit=max&auto=format&n=puCxqR1b6FB7kwaz&q=85&s=e5c55a662b494940bc31aff89ea9f5c7" alt="Account dropdown menu showing Join or create organization option" width="1040" height="1018" data-path="images/docs/flex/organizations/join-organization-menu.webp" />

## Create vs join

* **Create** when you are setting up a new team space and need admin control over projects, runners, policies, and members.
* **Join** when your team already has an organization and you only need access to shared resources inside it.

## What happens next

After creating or joining an organization, the usual next steps are:

* invite or manage members
* create or connect projects
* add runners or use Ona Cloud
* configure login, policies, and secrets for the team

See [Manage organization](/ona/organizations/manage-organization) and [Team management](/ona/organizations/overview) for the next layer of setup.
