Edit on GitHub

Install

Tilt is currently available for MacOS and Linux.

You’ll also need:

  • Docker, to build containers
  • Kubectl, to get information about your cluster
  • A local Kubernetes cluster (on MacOS, Docker For Mac works for this!)

On MacOS

kubectl config use-context docker-for-desktop

Installing the tilt binary is a one-step command:

curl -fsSL https://raw.githubusercontent.com/windmilleng/tilt/master/scripts/install.sh | bash

On Linux

sudo snap install microk8s --classic && \
microk8s.enable dns && \
microk8s.enable registry
  • Make microk8s your local Kubernetes cluster:
sudo microk8s.kubectl config view --flatten > ~/.kube/microk8s-config
KUBECONFIG=~/.kube/microk8s-config:~/.kube/config kubectl config view --flatten > ~/.kube/temp-config
mv ~/.kube/temp-config ~/.kube/config
kubectl config use-context microk8s

Installing the tilt binary is a one-step command:

curl -fsSL https://raw.githubusercontent.com/windmilleng/tilt/master/scripts/install.sh | bash

Verifying

After you install Tilt, verify that you installed it correctly with:

tilt version

Troubleshooting

If you have any trouble installing Tilt, look for the error message in the Troubleshooting FAQ.

Next Steps

You’re ready to start using Tilt! Try our Tutorial to setup your project in 15 minutes.


Alternative Installation

The 1-step installation script will install the most recent version of Tilt.

The installer first checks if you can install Tilt with Homebrew. If you’d prefer to run Homebrew manually, run:

brew tap windmilleng/tap
brew install windmilleng/tap/tilt

Otherwise, the installer downloads a static tilt binary and puts it under /usr/local/bin. See Tilt’s GitHub Releases page for specific versions. If you’d prefer to download the binary manually:

On MacOS:

curl -fsSL https://github.com/windmilleng/tilt/releases/download/v0.10.4/tilt.0.10.4.mac.x86_64.tar.gz | tar -xzv tilt && \
  sudo mv tilt /usr/local/bin/tilt

On Linux:

curl -fsSL https://github.com/windmilleng/tilt/releases/download/v0.10.4/tilt.0.10.4.linux.x86_64.tar.gz | tar -xzv tilt && \
  sudo mv tilt /usr/local/bin/tilt

Finally, if you want to install tilt from source, see the developers’ guide.

Building from source requires both Go and TypeScript/JavaScript tools, and dynamically compiles the TypeScript on every run. We only recommend this if you want to make changes to Tilt.