heroku-docker/docs/node-getting-started.md

# Node.js Getting Started

## Set up your environment

Get the project:

```
git clone https://github.com/heroku/node-js-getting-started.git
cd node-js-getting-started
```

Ensure that you can connect to Docker in this shell:

```
docker ps
```

## Create a Dockerfile

```
heroku docker:init
```

Heroku-Docker will automatically detect that this project is a Node.js app.

## Work locally with Docker

At this point, you have several available commands.

For example,
you could immediately build the project in Docker and release it to Heroku:

```
heroku create
heroku docker:release
heroku open
```

You can also run the server locally in a Dockerized version of Heroku's
Cedar-14 stack:

```
heroku docker:start
```

Finally, you could open a shell in Docker to manipulate the project with
commands like `npm install`:

```
heroku docker:exec bash
```

...or run such commands directly:

```
heroku docker:exec npm install --save express
```