Skip to main content

Organisation Setup

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

Creating an Organisation​

To create a new organisation, navigate to https://envio.dev and click the Hosted Service 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.

Add New Organisation Popup

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 hosted service UI.

Install Envio Deployments Page
Select Org and Install

Access Control​

Being a member of the GitHub organisation does not automatically grant access to the organisation in the Envio hosted service 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 the project" message.

Not a Member Error

Adding Members​

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

Add Members Button

Members List Page

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