Sharing and collaboration

Domino makes it easy to collaborate on projects and share project outputs.

There are two things that affect who has access to your project:

  • the project's visibility settings
  • the project's collaborators

Visibility Settings

You can change your project's visibility by going to the Access & Sharing tab of the project's settings page.

Screen_Shot_2018-09-25_at_6.53.41_PM.png

There are three different visibility options:

  • Public
    • Anyone can view your files and runs, even if they don't have a Domino account.
    • If file exports are enabled, anyone can import your project files.
    • Only explicitly added collaborators can modify files, start runs, or import environment variables (unless you check the allow runs by anonymous users box described below).
  • Searchable:
    • Anyone will be able to see this project exists, and see its name and description in search results.
    • However, they won't be able to view the project's contents.
  • Private:
    • Only collaborators can view this project or even discover its existence through search results.

If your project is publicly visible, there is an additional option to allow runs by anonymous users. This will allow users to start runs even if they don't have a Domino account. Runs started by anonymous users will show up as being started by the project owner.

Warning

Allowing anyone to run your code can be dangerous. Be careful granting this level of access, and make sure to think through any information you may be revealing, such as environment variables you have set in your project that contain bearer tokens, API keys, or passwords.

Managing collaborators

To grant other people more extensive access to a project, you can add them as collaborators. To add collaborators, you must be a Contributor to the project, or the project Owner.

Click Settings from the project menu, then click the Access & Sharing tab and scroll down to the Collaborators and permissions panel. You can add new collaborators by their username or email address. If you supply an email address belonging to a Domino user, that user will be invited to join the project as a collaborator. If you supply an email address that is not associated with an existing Domino user, an email will be sent to that address inviting them to join Domino.

Screen_Shot_2018-09-19_at_11.29.05_AM.png

The collaborators tab is also where you specify how each collaborator should be notified when runs complete. This can be a powerful tool to keep your collaborators in sync on the work that each person is doing.

Access levels

The owner of a project can set different access levels for collaborators from the Collaborators and permissions panel. The basic capabilities of the various types of project collaborators are as follows:

  • Contributors can read and write project files, and start runs. On the Settings page, Contributors can read and write project environment variables, and they can invite new collaborators, who will by default be new Contributors. Contributors cannot change hardware tiers, compute environments, or the access levels of collaborators.
  • Results Consumers can only read files and access published apps.
  • Launcher Users can only view and run Launchers, and see the launcher runs results. They cannot view project files.
  • Project Importers can import the project, but otherwise cannot access it.
  • Owners are the only user who can archive a project, change the owner, change collaborator types, set automatic workspace shutdown times, or change the project default hardware tier or environment.

For complete, itemized project permissions set on each type of collaborator, consult the tables below:

 

Files permissions

Permissions Project Importer Launcher User Results Consumer Contributor Owner
Read files      X X X
Write files       X X
Add external Git repo       X X

 

 

Runs permissions

Permissions Project Importer Launcher User Results Consumer Contributor Owner
Start run       X X
Start workspace       X X
Schedule a run       X X

 

Publishing permissions

Permissions Project Importer Launcher User Results Consumer Contributor Owner
Run launcher   X   X X
View Apps   X X X X
Publish App       X X
Unpublish App       X X
Invite users to App       X X
Change App hardware tier       X X
Publish model       X X
Create launcher       X X

 

Settings permissions

Permissions Project Importer Launcher User Results Consumer Contributor Owner
Set environment variables       X X
Invite collaborators       X X
Manage collaborator permissions         X
Change project visibility setting         X
Change default environment         X
Change default hardware tier         X
Change project name         X
Accept or deny merge request         X
Transfer project ownership         X
Archive project         X

 

Import permissions

Permissions Project Importer Launcher User Results Consumer Contributor Owner
Import project  X   X X
Was this article helpful?
3 out of 3 found this helpful