Managing Capsules

You can easily manage all your Capsules on the My Capsules page, or directly from the Code Ocean user interface for each particular Capsule. Code Ocean makes collaboration easier, by allowing you to share, edit access, and archive Capsules directly from the user interface.

Sharing Capsules

About Sharing a Capsule

Sharing a Capsule means that others can continue working from what you’ve developed—either in the same Capsule or in a duplicate Capsule. You can set Capsule permissions to collaborate with users and groups within your organization. Only authorized users can view/duplicate, or edit your Capsule. Shared Capsules are updated in near real-time on any changes made in the Capsule.

It is best practice to utilize Group sharing to ensure that new users will have all relevant Capsules, Data, and Pipelines available to them when they join, and that there will be no lost assets when team members leave.

Reach out to your Admin to configure Groups through your company’s chosen Identity Provider.

You can share a Capsule with secrets/credentials just like any other Capsule. To learn more about setting up secrets in Code Ocean, refer to the Secret Management Guide.

Navigate to Run a Shared Capsule with Secrets to learn how to run a shared Capsule with a secret.

Managing Capsule Permissions

Types of Permissions

The three types of permission for a Capsule are: Owner, Editor, and Viewer.





View a Capsule

Download a Capsule

Export a Capsule

Edit files in a Capsule

Execute a Reproducible Run

Work from a Cloud Workstation

Edit Capsule's permissions

Delete a Capsule

Setting Permissions for Collaborators

  1. Click Share at the top right corner of the Capsule. A permissions setting form opens.

  1. Type the name of the collaborator to invite or select the name from the drop-down menu. If groups are set up in your organization, they will also appear in the drop-down menu.

  1. Click the desired user’s name/email address in the dropdown to add the collaborator. The system adds the user to the Capsule permissions list. The permission level will be set as Viewer by default.

  1. To change a user's permissions or remove a user, click Viewer next to the desired user and choose the relevant option from the drop down.

  1. Click Save in the bottom right corner of the pop up to close the Capsule permissions setting form.

You can add more than one collaborator by repeating steps 2-3 before Saving.

To make a Capsule visible to all internal users, under General Access, Everyone select Viewer

To share the Capsule with Data Assets, check Share Assets. To share only the Capsule without Data Assets, ensure that Share Assets is deselected.

Owner/Admin Ability to Capture, Delete, and Rename Runs

Capsule Owners and Admins have the ability to rename and delete runs from other users, as well as create Result Data Assets from those runs. Code Ocean Admins also have the ability to see all runs on Release Capsules and rename or delete those runs.

Working on a Shared Capsule

View Mode

When you add a collaborator with the permission to view the Capsule, the collaborator can view all the folders and files from the Capsule IDE, download individual files, export, and duplicate the Capsule.

To execute or modify code in the Capsule as a Viewer, you will need to duplicate the Capsule prior to editing.

Anyone with View Access can attach secrets to the Capsule that is shared with them

​Edit Mode

When you share a Capsule with the edit permission, the collaborator can change any file's content and execute code in a Capsule. Only one user can edit the shared Capsule at any given time. All collaborators can view the same Capsule simultaneously. When a collaborator is editing the Capsule, all others will see the Capsule in the view-only mode indicated by a message on top of the center section of the Capsule IDE and the deactivated buttons in the right Timeline section.

Click Start editing to begin editing above the Editor in the center. If a collaborator's name appears in the message, they are forced into the read-only mode after your click.

Before you decide to edit the Capsule when a collaborator appears to be editing, it is strongly recommended that you communicate with your collaborator in advance, so they don't lose their work.

When you're done, click Finish editing.

Duplicating a Capsule

How to create a private copy of either released or unreleased code.

Duplicating a Capsule allows you to create a copy of it while keeping the original unchanged. To duplicate a compute capsule:

  1. Navigate to your My Capsules Dashboard,

  2. Click on the Capsule you would like to duplicate, which will open the Capsule IDE

  3. Click Capsule in the menu at the top of the screen

  4. Select Duplicate. This process will create an exact copy of the Capsule, which will open and be added directly to your My Capsules Dashboard

Archiving a Capsule

Capsules and Data Assets can be archived to reduce clutter in the Capsules/Data Assets list. Archiving removes a Capsule/Data Asset from the 'All' view, making them accessible through the Archive view

  1. To begin the process of archiving your capsule, Navigate to your My Capsules dashboard.

  1. To arching your Capsule directly from the My Capsules Dashboard, hover over the desired Capsule and click Archive in the toolbar selection that displays

Restoring an archived Capsule

  1. To view an archived Capsule/Data Asset, click Archive in the menu. All the archived Capsules/Data Assets are listed

  1. To restore a Capsule from the Archive, scroll the cursor over the Capsule and click the Restore Capsule icon in the toolbar

  1. Click Back to My Capsules Assets to return

Modify/Remove Capsule Permissions

  1. Navigate to your Capsule and click Share at the top right corner of the screen to open your permissions settings form

  2. Navigate to the collaborator you would like to modify.

  3. Change or remove a user's permissions by clicking on the drop-down menu next to the user and selecting the relevant option.

Click Save to close the Capsule permissions setting form.