Tilt, Kubernetes, and Docker may be new tools for developers entering the Wormhole ecosystem. This section is meant to provide some additional support when setting up the Wormhole Tilt environment.
Install Homebrew if you don't already have it.
You can grab it with:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
From there, all the other installs are one-liners.
brew install go
brew install docker
After installation, go into Docker settings and switch ON
kubernetes. Also configure Docker to have 4 CPUs and ~16GB of RAM.
brew install tilt
git clone --branch dev.v2 https://github.com/wormhole-foundation/wormhole.git cd wormhole/ tilt up
You'll be able to access the Tilt UI at
If you're using a Debian distro, you should run the dev-setup.sh script. Even if you're not using Debian, this script still contains the main steps for setup.
wget https://go.dev/dl/go1.18.1.linux-amd64.tar.gz rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.1.linux-amd64.tar.gz
If you're using Linux with a window manager, consider getting Docker Desktop instead of the following command. It comes with Kubernetes built in and you won't need to download
minikube. It's recommended to have at least 4 CPUs and 16GB RAM dedicated to Docker.
Also, make absolutely sure that you set up Docker as a non-root user.
Enable Kubernetes by going into Settings > Kubernetes
minikube start --driver=docker --kubernetes-version=v1.23.3 --cpus=4 --memory=14G --disk-size=10G --namespace=wormhole
Minikube needs to be running for tilt to work, so always make sure to run
minikube start before you bring up tilt.
Install Tilt by copy pasting this into the Terminal:
curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash
git clone --branch dev.v2 https://github.com/wormhole-foundation/wormhole.git
If you're running Tilt on your machine:
cd wormhole/ tilt up
If you're running Tilt in a VM, you'll need to pass in some extra flags to enable Tilt to listen to incoming traffic from external addresses:
cd wormhole tilt up --host=0.0.0.0 -- --webHost=0.0.0.0
You can now access the Tilt UI at either
If the VM's external IP doesn't work, check firewall and port settings to make sure your VM allows incoming traffic.