> For the complete documentation index, see [llms.txt](https://docs.envio.dev/llms.txt).

# Organisation Setup

Use this guide to set up an organisation in Envio Cloud and grant access to your team.

---

## Creating an Organisation

To create a new organisation, navigate to [https://envio.dev](https://envio.dev) and click the **Cloud** button in the top right corner. Log in with GitHub, then in the top-left menu, select **Install App**. This action redirects you to GitHub, where you can install the **Envio Deployments** app for the relevant GitHub organisation.

<div style={{textAlign: 'center'}}>

![Add New Organisation Popup](/img/org-setup/add-new-organisation-popup.png)

</div>

On GitHub, choose the organisation you want to enable and complete the installation. Once approved, GitHub returns you to the new organisation's page in the Envio Cloud UI.

<div style={{display: 'flex', gap: '1rem', justifyContent: 'center', alignItems: 'center', flexWrap: 'wrap'}}>
  <div style={{flex: '1', minWidth: '300px', maxWidth: '500px'}}>
    <img src="/img/org-setup/install-envio-deployments-page.png" alt="Install Envio Deployments Page" style={{width: '100%', height: 'auto'}} />
  </div>
  <div style={{flex: '1', minWidth: '300px', maxWidth: '500px'}}>
    <img src="/img/org-setup/select-org-install-page.png" alt="Select Org and Install" style={{width: '100%', height: 'auto'}} />
  </div>
</div>

---

## Access Control

Being a member of the GitHub organisation **does not** automatically grant access to the organisation in the Envio Cloud UI. Each member must be explicitly added by the organisation admin. If someone attempts to visit the organisation URL (e.g., `https://envio.dev/app/<org-name>`) without being added, they'll see a "You are not a member of this team" message.

<div style={{textAlign: 'center'}}>

![Not a Member Error](/img/org-setup/not-a-member-error.png)

</div>

---

## Adding Members

The organisation admin must add members from the organisation page in Envio. Navigate to the **Members** page to see all users associated with your GitHub organisation, then grant access by selecting **Add** next to each person.

<div style={{textAlign: 'center'}}>

![Members Page Button](/img/org-setup/members-page-button.png)

</div>

<div style={{textAlign: 'center'}}>

![Members List Page](/img/org-setup/members-list-page.png)

</div>

Once added, members should be able to access the organisation's page in the Envio Cloud UI and start creating projects!

---