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 | 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(''))

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:

💡 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.


Was this doc helpful?

Back to top Edit on GitHub