These instructions only apply for free self-hosting features, not Enterprise features (feature list).

Read the self-hosting instructions before deploying to production.

Create a VM

Go to the Compute Engine service and click CREATE INSTANCE. Create an instance with default settings except:

  • e2-medium for testing, e2-standard-2 for production
  • Enable Allow HTTP traffic and Allow HTTPS traffic

Install Docker

Go to your Compute Engine instance page and click SSH.

Install Docker & Docker Compose with the following commands:

sudo apt-get update && sudo apt-get install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common wget
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add --
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian buster stable"
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io
sudo usermod -a -G docker $USER
curl -s https://api.github.com/repos/docker/compose/releases/latest | grep browser_download_url  | grep docker-compose-linux-x86_64 | cut -d '"' -f 4 | wget -qi -
chmod +x docker-compose-linux-x86_64 && sudo mv docker-compose-linux-x86_64 /usr/local/bin/docker-compose
docker-compose --version
Refresh the VM console page to activate the new configuration.

Run Nango

Still in your VM’s console, install Nango by running:

mkdir nango && cd nango
wget https://raw.githubusercontent.com/NangoHQ/nango/master/docker-compose.yaml
docker-compose up -d # Nango is now running!

Update Nango

In your VM’s console, run:

docker-compose stop
docker-compose rm -f
docker-compose pull
docker-compose up -d