Getting Started

This guide will walk you through trying blimp with a Node.js example. If you’d like to try our own docker-compose.yaml, you can follow these instructions as well.

For Windows users, check out the Windows guide instead.

Node.js Example

  • Node Todo (Github) is a simple Node.js todo list application developed by

Clone the example

git clone
cd node-todo

Install Blimp

curl -fsSL '' | sh

Or, we’re also on Homebrew:

brew install kelda/tools/blimp


blimp login

Boot in the cloud

blimp up

If you have docker installed locally, and want to try the image building feature, run blimp up -f ./docker-compose-local-build.yml instead.

Check status

$ blimp ps
mongo    Running
web      Running

View logs

blimp logs web

Get a shell

blimp ssh web

Access localhost

Just as you can with Docker Compose, Blimp allows you to use your browser to access services. For instance, if you were running the Node Todo example you could view the website using the following command. Or, of course, open localhost:8080 in your browser.

$ curl http://localhost:8080
<html> ... </html>

Change code

Any bind volumes that your docker-compose file mounts will be automatically synchronized using Syncthing. Edit your code locally and changes automatically propagate into the containers.

You’re now up and running with Blimp!

Be sure to try running your own application after you finish up with the example.

Let us know how it went

Answer a couple questions to help us continue improving the development experience for Docker.

Try Blimp with your Compose file

Next we recommend trying Blimp with your own Compos file. To do so, simply:

  1. Shut down the example with Ctrl-C
  2. Navigate to your docker-compose.yaml
  3. Run blimp up