Preparation (Optional)
Tilt Tutorial
For this tutorial, we’ll focus on Tilt fundamentals by walking through a sample project.
Our sample project uses Docker for building container images and Kubernetes for running them. However, it’s possible to use Tilt without Docker or Kubernetes! Tilt is incredibly flexible and supports a variety of ways to build and run your services during local development.
We won’t actually dive into a Dockerfile or Kubernetes YAML, since that’s out of scope for this introduction.
To follow along interactively, you’ll need to have Docker and Tilt installed on your machine.
Prefer not to download additional tools? You can still follow along on the web - go ahead and skip to the next section!
💁♀️ Not using Kubernetes or Docker?
We’ve got plenty of guides for using Tilt with Helm, podman, local processes, and more to help you get started after learning the Tilt fundamentals from this tutorial.
Install Tilt
On macOS/Linux, we’ve got an install script that will use Homebrew if available (and a direct download otherwise):
curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash
On Windows, we’ve got an install script that will use Scoop if available (and a direct download otherwise):
iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.ps1'))
If you’d rather install manually or via another method, refer to the guide on Alternative Installations.
Install Docker
Docker provides comprehensive install instructions for all supported OSes and Linux distributions:
- Docker Desktop for Mac
- Desktop Desktop for Windows (including WSL)
- Docker for Linux
- Ubuntu
- Direct from binary
- All other distributions
- Convenience script (auto-detects distribution):
curl -fsSL https://get.docker.com | sh
💡 On Linux, following the Manage Docker as a non-root user post-install guide is suggested so that you don’t have to run Tilt with
sudo. (Please take careful note of the security considerations outlined in the guide.)
A quick way to test out your Docker install is to run the hello-world container:
docker run --rm hello-world
You should see some output from Docker as it downloads the hello-world image followed by a greeting message with some information about Docker.
If you are having trouble, Docker provides troubleshooting guides for macOS and Windows.