Skip to main content

Connect to Outerbounds

There are two main ways to develop and execute code on Outerbounds:

  1. You can use Outerbounds cloud workstations through Visual Studio Code IDE, backed by cloud instances hosted as a part of the platform in your cloud account.

  2. You can access the platform from any existing development environment, such as laptops or other cloud-based environments.

Follow the instructions below to get started!

Invite users to the platform

First, make sure that users have been invited to the platform by listing their email in the user management view. After a user has been invited, they can log in to the platform via the configured SSO provider, allowing them to set up their personal access.

Tokens are personal

Users shouldn't share their personal access tokens. If you need shareable access tokens that are not tied to a user, see instructions for setting up machine users.

Connect to the platform

You can connect to the platform from your existing development environment or you can use a cloud workstation - choose below. If you have an existing installation of open-source Metaflow in your environment and you want to use Outerbounds in the same environment, choose the third option.

First, open the Local Setup tab under Getting Started / Workspace. It looks like this:



Open a terminal or a notebook and install the outerbounds package:

pip install -U outerbounds

You can install the package in a Python virtual environment but it is not required. Next, copy-paste the long configuration string in your terminal or notebook and execute it:

outerbounds configure <long token from the UI>

This command will save your personal access token in a system-wide configuration file.

You are now ready to start using the platform! 🎉


Troubleshooting the connection

If you ever run into problems with the connection, execute outerbounds check -v to see details about your setup. You should see a row of OKs if everything works correctly. Otherwise contact your support Slack.