Edit on GitHub

Install

Having trouble getting started with Tilt? Schedule a video call with Dan Miller, Senior Software Engineer at Tilt.

Tilt is available for macOS, Linux, and Windows.

You’ll also need:

  • Docker, to build containers
  • kubectl, to get information about your cluster
  • A local Kubernetes cluster (on macOS and Windows, Docker for Desktop works for this!)

macOS

Docker for Mac contains Docker, kubectl, and a Kubernetes cluster.

kubectl config use-context docker-desktop
  • Install tilt with:
curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash

Linux

sudo snap install microk8s --classic && \
sudo microk8s.enable dns && \
sudo 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
  • Install tilt with:
curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash

Windows

Tilt’s Windows support is currently a release candidate.

Docker for Windows contains Docker, kubectl, and a Kubernetes cluster.

kubectl config use-context docker-desktop
  • Install tilt with:
iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.ps1'))

If you have Scoop installed, the installer will use that to make Tilt easy to access and upgrade.

Otherwise, you will need to add the tilt install directory on your $PATH (or create an alias) to make it easier to access.

Verify

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 Installations

We offer 1-step installation scripts that will install the most recent version of Tilt.

The installer first checks if you can install Tilt with a package manager, like Homebrew or Scoop.

You can also use these installers directly.

Homebrew (macOS)

brew install tilt-dev/tap/tilt

Scoop (Windows)

scoop bucket add tilt-dev https://github.com/tilt-dev/scoop-bucket
scoop install tilt

Manual Install

If you don’t have a package manager installed, the installer will download a tilt static bianry for you and put it in a reasonable place. (~/.local/bin, /usr/local/bin, or ~/bin depending on your OS and what’s already on your $PATH.

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/tilt-dev/tilt/releases/download/v0.16.0/tilt.0.16.0.mac.x86_64.tar.gz | tar -xzv tilt && \
  sudo mv tilt /usr/local/bin/tilt

On Linux:

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

On Windows:

Invoke-WebRequest "https://github.com/tilt-dev/tilt/releases/download/v0.16.0/tilt.0.16.0.windows.x86_64.zip" -OutFile "tilt.zip"
Expand-Archive "tilt.zip" -DestinationPath "tilt"
Move-Item -Force -Path "tilt\tilt.exe" -Destination "$home\bin\tilt.exe"

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.

 
 
 

Was this doc helpful?