Running your instance

Getting started with Cobrowse. Follow these simple steps to bootstrap your account and configure the SDK to use your private instance.

Once your self-hosted instance is up and running, there are a few steps to bootstrap the account and configure our SDKs to use your private instance.

Register an account

Once your instance is up and running, you will need to register yourself an account. Head to https://<your instance domain>/register to setup your account.

You may register multiple accounts in your instance if you would like. Some customers register accounts for dev, test, staging, etc.

If you are using the Email "magic link" sign-in flow, but do not have a mail server set up and have disabled our default mail provider, then please retrieve the "magic link" from the application logs of the cobrowe-api container by temporarily setting the environment variable:

DEBUG=cbio.email

This should be reverted to avoid the risk of credential leaks through the application logs.

Setting API location in the SDKs

You will need to set the API location when integrating the SDKs in order to point them at your private instance.

When specifying the API, please do not use a trailing slash.

Web

CobrowseIO.api = "https://cobrowse.example.com";

Insert this line into your Cobrowse initialisation logic. It must be inserted before CobrowseIO.start() is called.

If using our provided snippet, you can put this before or after the CobrowseIO.license = "..." line.

iOS

CobrowseIO.instance.api = @"https://cobrowse.example.com";

Android

CobrowseIO.instance().api("https://cobrowse.example.com");

Useful resources

Now your instance is up an running, you should review the documentation below to fine tune your deployment.

Adding a superuser

Limiting account creation

Configuring SMTP

Managing your deployment