> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt. For full content including API reference and SDK examples, see https://learning.postman.com/llms-full.txt.

# Run Newman with Docker on macOS, Ubuntu, and Windows

[Docker](https://www.docker.com/) is a platform for building and running applications in a virtual environment. You can use [Newman](/docs/reference/newman-cli/command-line-integration-with-newman/) to run your Postman Collections in a Docker container. When running collections in Docker, you can use all available Newman command options and run local collection files.

## Use Newman with Docker on macOS and Ubuntu

To use Newman with Docker for macOS or Ubuntu, do the following:

1. Make sure Docker is installed and running on your system. Go to [Get Docker](https://docs.docker.com/get-docker/), choose your operating system, and follow the instructions.

2. To test your Docker installation, run the following command:

   ```bash
   docker run hello-world
   ```

3. Pull the [Newman Docker](https://hub.docker.com/r/postman/newman/) image from Docker hub:

   ```bash
   docker pull postman/newman;
   ```

4. Run Newman commands on the image. For example, to run a [collection](/docs/sending-requests/create-requests/intro-to-collections/), use the collection ID and your Postman API key:

   * To get the collection ID, select a collection in the sidebar. Click <img alt="Info icon" src="https://assets.postman.com/postman-docs/aether-icons/state-info-stroke.svg#icon" width="16px" role="img" /> **Info** and copy the ID.

   * To get an API key, go to [Generate a Postman API key](/docs/reference/postman-api/authentication/#generate-a-postman-api-key).

   ```bash
   docker run -t postman/newman run "https://api.getpostman.com/collections/<collection-id>?apikey=<your-api-key>"
   ```

The collection runs in Newman, and the output displays in the terminal.

The entry point to the Docker image is Newman, so you can use all Newman command line parameters. You can also run locally stored collection files. The [Newman Docker documentation](https://hub.docker.com/r/postman/newman/) describes how to mount shared data volumes.

## Use Newman with Docker on Windows

To learn more about using Newman with Docker on Windows, go to [Using the Newman Docker Image in Windows](https://blog.postman.com/using-the-newman-docker-image-in-windows/).

## Next steps

For more information about running Postman Collection runs, see the following:

* [Test your API using the Collection Runner](/docs/collections/running-collections/intro-to-collection-runs/)
* [Run collections using imported data](/docs/collections/running-collections/working-with-data-files/)
* [Customize request order in a collection run](/docs/collections/running-collections/building-workflows/)
* [Integrate your Postman tests with Jenkins using Newman](/docs/reference/newman-cli/integration-with-jenkins/)
* [Integrate your Postman tests with Travis CI using Newman](/docs/reference/newman-cli/integration-with-travis/)