Get started with Blimp
Create your free Blimp account and have your own apps up and running instantly.

Forgot your password?

Don't worry! Enter your e-mail address and we'll send you a link to reset your password.

Get Started in 3 Steps!

Install, login and boot Blimp in minutes.

Try with your own Compose file, or use our example app.

Step 1 of 3

Install Blimp

Select your platform to get install instructions for the Blimp CLI.

You run the CLI from your laptop in order to interact with your development environment.

1. Install

brew install kelda/tools/blimp

or

curl -fsSL 'https://kelda.io/get-blimp.sh' | sh

2. Login

blimp login

This will open a login page in your browser, at which point you can login, or create a new account. The command then gets your Blimp token, which is used to authenticate you and identify your development environment.


1. Install

curl -fsSL 'https://kelda.io/get-blimp.sh' | sh

2. Login

blimp login

This will open a login page in your browser, at which point you can login, or create a new account. The command then gets your Blimp token, which is used to authenticate you and identify your development environment.


Select your setup: A native Windows binary or within Windows Subsystem for Linux

  • The WSL setup requires additional setup in order to connect to Docker Desktop to build Dockerfiles.

Native binary

1. Install

2. Login

blimp login

This will open a login page in your browser, at which point you can login, or create a new account. The command then gets your Blimp token, which is used to authenticate you and identify your development environment.

Blimp in WSL

These commands must be run inside a Windows Subsystem for Linux instance. We recommend Ubuntu.

1. Install

curl -fsSL 'https://kelda.io/get-blimp.sh' | sh

2. Login

blimp login

This will open a login page in your browser, at which point you can login, or create a new account. The command then gets your Blimp token, which is used to authenticate you and identify your development environment.

Step 2 of 3

Try Example App


This guide will walk you through trying Blimp with a simple Node.js todo app (originally developed by scotch.io.

  1. Clone the example
  2. Boot in the cloud
  3. Access the app
  4. Change some code
  5. Create shareable link
  6. Explore commands & config

Clone the Example

Run the following commands to download the repo, and change directories into it. blimp up in the same directory as your yaml.

git clone https://github.com/kelda/node-todo

cd node-todo

The example repo has the source code for the Node.js todo app, and a docker-compose.yml that defines the services it needs to run.


Boot in the cloud

blimp up

This command:

  • Boots up all the containers.
  • Syncs the local code into the Node.js container.
  • Sets up tunnels so that you can access the containers as if they were running locally.

This step takes about a minute. Wait for the containers to boot, and for them to start printing logs


Access the app

  1. Open up http://localhost:8080 in your browser to access the app.

  2. Add a couple todos!

You’re ready to start interacting with your application once blimp up shows the application’s logs.

Just as you can with Docker Compose, Blimp allows you to use your browser to access services.


Change Some Code

Open app/routes.js in your favorite text editor, and uncomment line 12.

Once you save, your code change will be automatically synced into the container. If you reload localhost:8080 you’ll see that each todo is prepended with “Kelda:”.

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.


Explore Commands

Blimp has all the commands that you need for a complete development workflow, such as getting logs and restarting containers. These commands have the same behavior as their docker-compose counterparts.

Run blimp help to check them out.


Explore configuration

Blimp is configured with a regular Docker Compose file, and supports all the Docker Compose features critical for development, such as volumes, build, and ports.

Take me to the docs

Step 3 of 3

Try with your own Compose file

If you have a Docker Compose file, then you have all the configuration you need to run it in the cloud with Blimp. To try Blimp out with your own app:

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

Welcome, you are all set up with Blimp!

You are currently using the free Blimp plan.

Ready for more, check out our Pro, Team or Self-Hosted plans.