Do not use (yet)!
Work in progress.
This guide is designed to guide your through the installation of BitGo Express node, to enable CAS to use your BitGo wallet (on the BitGo website) after you’ve created your BitGo account (on their website).
BitGo Express is designed and written by BitGo for their BitGo website wallet.
IMPORTANT: you will be exposing your BitGo wallet's private keys on this server. This may be a substantial security risk. Without airtight protection, your funds might be exposed. Securing your server is of paramount importance. If you proceed, you are doing so at your own risk.
BitGo holds and secures your cryptocurrency keys.
BitGo Wallet is a hot wallet option in the Crypto Application Server (CAS).
BitGo Express is used to interface with BitGo. CAS does not interact with BitGo directly.
This article presumes you have a bare installation of Ubuntu 20.04 LTS running on a VPS with a publicly exposed IP.
These instructions are illustrated using a non-root account. “root” installation & usage will be different and is not recommended.
We recommend Digital Ocean as your VPS provider: Create a VPS on Digital Ocean
1. Install Docker.
Install the Ubuntu dependencies:
sudo apt update && sudo apt dist-upgrade sudo apt-get install ca-certificates curl gnupg lsb-release
Install the product signatures to verify file integrity:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update
Install the latest stable version of Docker:
sudo apt-get install docker-ce docker-ce-cli containerd.io
Assuming the installation went as planned, this next command should succeed:
sudo docker run hello-world
Success looks like this:
2. Install the GB Tunnel.
Click this link to open installation instructions.
Requires CAS version 20200323 or newer.
Required when using the GB Cloud as your CAS server.
3. Install & run Bitgo Express.
Navigate to your home directory (~). The home directory is the default login directory.
cd ~
Run BitGo Express:
sudo docker run -it -p 3080:3080 bitgosdk/express:latest -p 3080 -e prod --disablessl
This is an example of a successful start:
4. Test it.
Verify that your node is working properly by sending a command via another terminal window.
Open a new Terminal window/tab.
Login on the second window via SSH to the Bitgo Express node.
Type the following:
curl localhost:3080/api/v2/ping
You should see something similar to this reply:
On the first window, you’ll see confirmation that the second window said “hello”:
Great, everything seems to be working with that! You can close the second window, we’re done there.
You’ll also see messages from CAS (in the first window) as you test the Hot Wallet settings. This is an easy way to diagnose any problems.
5. Ensure continuity.
BitGo Express MUST be running at all times to be available as a Hot Wallet for CAS. If the program terminates for any reason, the Hot Wallet will fail to function. If the server goes down, so does your Hot Wallet. You need the server up & Bitgo Express operating constantly for proper operation.
The best way to ensure that Bitgo Express is always running is to implement Docker’s detached mode:
sudo docker run -d -p 3080:3080 bitgosdk/express:latest -p 3080 -e prod --disablessl &
This is an example of BitGo Express successfully started in the background (detached mode):
the reply indicates that Bitgo Express was successfully started, and assigned an identifier. That number will vary every time - and it’s not very important unless you wish to stop the program. Normally you won’t stop the program.
To stop Bitgo Express, simply re-attach the container (use the first 12 characters of the identifier):
sudo docker attach a2be980a8ef9
you can now close Bitgo Express by pressing Ctrl-C, or
watch incoming test messages from CAS (or another window, as described above).
6. Create a new Crypto Setting for use with this node.
More Hot Wallet & Exchange guides:
Title | Creator | Modified |
---|---|---|
BitGo Express via Docker | Charles Wernicke | Apr 25, 2024 |
Bitcoin Core (BTC) Node for CAS | Charles Wernicke | Apr 10, 2024 |
Geth Ethereum Node for CAS | Charles Wernicke | Mar 22, 2024 |
Lightning Network on ATM with Bitcoin Core, LND and CAS | Charles Wernicke | Dec 15, 2023 |
Create a VPS on Digital Ocean | Charles Wernicke | Jul 06, 2023 |
Bitcoin Cash (BCH) Node for CAS | Charles Wernicke | Jun 12, 2023 |
DOGE Node for CAS | Charles Wernicke | Mar 21, 2023 |
Monerod (XMR) Node for CAS | Charles Wernicke | Mar 21, 2023 |
Cardano Node Installation | Charles Wernicke | Mar 21, 2023 |
Install the GB Wallet Tunnel Server | Charles Wernicke | Mar 21, 2023 |
DASH Core Node for CAS | Charles Wernicke | Jun 11, 2021 |