Root SSH Access is required to proceed. You should contact your server provider on how to obtain the root ssh credentials. For cPanel users, check the SSH Access (root) section

Running BitGo Express

Docker

To install the latest version of docker on your server, see the Docker section

For most users, we recommend running BitGo Express as a docker container, since this is the most secure way to run BitGo Express.

Run the following code to quickly start BitGo Express in the Test Environment

docker run -it -p 3080:3080 bitgosdk/express:latest --port 3080

You should see this output from the container:

BitGo-Express running
Environment: test
Base URI: http://0.0.0.0:3080

From the output the BitGo Host will be listening on all interfaces under the Port: 3080. In the event that you want the Port otherwise, you should change it from the parameters in the command.

Docker in Production (SSL)

You need to obtain a valid SSL certificate credentials for your domain or generate a self-signed one:

Generating Self-signed Certificate (optional)

First make a directory and navigate into it:

$ cd ~
$ mkdir certs
$ cd certs

Then run the following command and complete the prompted information:

$ openssl req -newkey rsa:2048 -nodes -keyout cert.key -x509 -days 3650 -out cert.crt

This will output a key file cert.key and certificate file cert.crt in the current directory

Running Command:

Take note of the path to your SSL certificate credentials folder which contains key file say cert.key and certificate file say cert.crt Replace /path/to/cert in the following command with the full qualified path to the above folder

docker run -it --volume /path/to/certs:/private -p 3080:3080 bitgosdk/express:latest --env prod --port 3080 --keypath /private/cert.key --crtpath /private/cert.crt

If the certificate files are saved with a different name, you should update the parameters in the command accordingly.

You should see this output from the container:

BitGo-Express running
Environment: prod
Base URI: https://0.0.0.0:3080

Now Bitgo Express is listening to all interfaces, under the BitGo Port: 3080

The following is the information you will need to integrate with the script:

• Host/Domain: The domain of the server it is running on

• Port: 3080 or otherwise as specified in the setup from above.

• Long Lived Access Token: This can be obtained from your BitGo Dashboard, please use the following guide.

You may use any of the following commands to interact with a running container

• Stop a specific container.

$ docker stop [container id]

• List all running containers

$ docker ps

• Display logs of a container.

$ docker logs [container id]

Docker in Production (without SSL)

Run the following if you want to start Bitgo Express without SSL safely.

docker run -it -p 3080:3080 -e DISABLE_SSL="1" bitgosdk/express:latest --env prod --port 3080

You should see this output from the container:

BitGo-Express running
Environment: prod
Base URI: http://0.0.0.0:3080

Then you can access the running instance with http://localhost as BitGo Host and 3080 as BitGo Port

Generate Long Lived Access Token

1. Login to the appropriate BitGo dashboard based on the environment you want to setup on. Test: Uses testnet chain. Sign up & Login Here Production: Uses main chain. Sign up & Login Here​

2. Click your account name at the top right, click User Settings.

3. Under Developer Options tab, click on Create Access Token.

4. Generate a long lived token for your installation on this page.

1. (Required) Set the label & live time of your token. You have ten years entered by default. 2. (Required) Set the Lifetime Spending Limits of the token. You may set a maximum of 100000000 for all coins. 3. (Required) Enter the unique IP address of your server where the BitGo Express has been installed. (see above) 4. (Required) Grant the token all permissions as shown below