Big News!  Tilt is joining Docker

Install

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.

  • Install Docker for Mac
  • In the preferences, click Enable Kubernetes
  • Make Docker for Mac your local 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

  • Install Docker
  • Setup Docker as a non-root user.
  • Install kubectl
  • Install ctlptl and use it to create Kind with a local registry
  • Install tilt with:
    curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash
    

Alternatively, Ubuntu users sometimes prefer Microk8s instead of Kind because it integrates well with Ubuntu. See the Choosing a Local Dev Cluster guide for more Linux options.

Windows

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

  • Install Docker for Windows
  • In the preferences, click Enable Kubernetes
  • Make Docker for Windows your local Kubernetes cluster:
    kubectl config use-context docker-desktop
    
  • Install tilt with Powershell:
    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 learn about Tilt or jump right in with the Write a Tiltfile Guide.


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 or Linux)

brew install tilt-dev/tap/tilt

Scoop (Windows)

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

Conda Forge

conda config --add channels conda-forge
conda install tilt

asdf

asdf plugin add tilt
asdf install tilt 0.33.20
asdf global tilt 0.33.20

Manual Install

If you don’t have a package manager installed, the installer will download a tilt static binary 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.33.20/tilt.0.33.20.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.33.20/tilt.0.33.20.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.33.20/tilt.0.33.20.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.