Docker containers encapsulate everything an application needs to run. To make it easier for you to automate the management of Akamai services, we bundled the base Akamai command-line interface (CLI), many CLI packages, and third-party tools like HTTPie, cURL, and Terraform into a Docker container, called Akamai Developer Environment. You can use the same docker command to run the Akamai Developer Environment on Linux, macOS, and Windows.

Install Docker Desktop

Download the Docker Desktop for your operating system at and run the installation program.

Once Docker Desktop is installed, click the docker icon and make sure it says “Docker Desktop is Running.”


First, follow the instructions to Create authentication credentials.

Then, issue this command to authenticate your API requests:
docker run --rm -it --name akamai -v $HOME/.edgerc:/root/.edgerc akamai/shell

This mounts your local $HOME/.edgerc into the container. To change the local path, modify the -v argument.

Run the Docker container

Once you've installed Docker, you can issue a command to set up the Akamai Development Environment.

Issue this command to run Docker in interactive mode:
docker run --rm -it --name akamai akamai/shell

This will automatically:

  • Name your Docker image akamai.

  • Put the contents from the Docker Hub under akamai/shell.

  • Install the base Akamai CLI and CLI packages you can use to manage different services

  • Install HTTPie, cURL, and Terraform as well as runtime dependencies like Python, Node.js, and GoLang

Use the docker pull command to access additional builds on the Akamai Docker Hub.

You can find additional instructions about the Akamai Development Environment.


If you’re using the Akamai Development Environment with the Apple M1 chip, you might experience issues. You can install the CLI with Homebrew as a workaround.

Video demo

To see a demonstration of this process, check out this video: