Inviting collaborators allows you to share access to a dedicated database while keeping full control over who can manage it.

Unlike Shared Resources databases, a Dedicated Resources database has its own collaborators.

Listing Collaborators of a Database

Using the Dashboard

1. From your web browser, open your dashboard
2. Once on the database dashboard, click the Settings tab, then select Collaborators

Using the Command Line

1. Make sure you have correctly setup the Scalingo command line tool
2. From the command line, list the collaborators:

   scalingo --database my-dedicated-db collaborators
   

   The output should look like this:

   ┌──────────────────────────────┬──────────┬──────────┬──────────────┐
   │            EMAIL             │ USERNAME │ STATUS   │     ROLE     │
   ├──────────────────────────────┼──────────┼──────────┼──────────────┤
   │ user1@example.com            │ user1    │ owner    │ owner        │
   │ user2@example.com            │ user2    │ accepted │ collaborator │
   │ user3@example.com            │ n/a      │ pending  │ collaborator │
   └──────────────────────────────┴──────────┴──────────┴──────────────┘
   

Inviting a Collaborator

Using the Dashboard

1. From your web browser, open your dashboard
2. Once on the database dashboard, click the Settings tab, then select Collaborators
3. Click the Add button
4. Fill the input field with the e-mail address of the collaborator
5. Confirm
6. The collaborator is added and appears dimmed in the list
7. An invite is sent by e-mail to the collaborator
8. Once the invite is accepted, the collaborator appears normally in the list

Using the Command Line

1. Make sure you have correctly setup the Scalingo command line tool
2. From the command line, invite someone:

   scalingo --database my-dedicated-db-id collaborators-add user@example.com
   

   The output should look like this:

   -----> user@example.com has been invited to collaborate to my-dedicated-db
   

Removing a Collaborator

Using the Dashboard

1. From your web browser, open your dashboard
2. Once on the database dashboard, click the Settings tab, then select Collaborators
3. Locate the collaborator for whom you want to revoke access
4. Open the contextual menu by clicking the corresponding … button
5. Select Revoke access
6. Confirm by clicking the Revoke access to button in the popup window

Using the Command Line

1. Make sure you have correctly setup the Scalingo command line tool
2. From the command line, revoke the access:

   scalingo --database my-dedicated-db-id collaborators-remove user@example.com
   

   The output should look like this:

   -----> user@example.com has been removed from the collaborators of my-dedicated-db
   

Stopping Collaborating

If you are currently working collaboratively on a dedicated database and have no more interest in participating, you can stop collaborating on your own.

Using the Dashboard

1. From your web browser, open your dashboard
2. Once on the database dashboard, click the Settings tab, then select Collaborators
3. Locate yourself in the list of collaborators
4. Open the contextual menu by clicking the corresponding … button
5. Select Revoke access
6. Confirm by clicking the Revoke access to button in the popup window