The entire Portainer development stack inside a container (including the IDE!)
10K+
The Portainer development toolkit is a containerized development environment for Portainer!
Works on Linux and MacOS!
For previous versions of the toolkit that also included the VSCode IDE, see the branch 2024.08.
Install the devcontainer extension in your IDE of choice. For more information on supported IDEs, see the devcontainer documentation.
Configure your workspace to use the devcontainer.json file in this repository.
Open your project in your IDE using the Open Folder in Container option and start coding!
Have a look at the rest of the documentation below for more configuration/customization options.
This toolkit is based on the Ubuntu 24.04 LTS image and comes with the following tools pre-installed:
See Dockerfile for more details.
The portainer/dev-toolkit image is using DockerHub automatic builds to build multi-arch (amd64, arm64) images based on this git repository tags.
E.g. creating and pushing a new 2024.10 tag in this repository will automatically build portainer/dev-toolkit:2024.10.
Follow the instructions below if you wish to build the image manually.
Warning
Currently, the multi-arch image for Linux ARM64 and Linux AMD64 must be built on a Linux AMD64 host. See https://github.com/docker/buildx/issues/495#issuecomment-761562905 for more details about the issue.
Use the following command to build and push the base image (make sure you are authenticated to DockerHub first):
make base
All you need to have installed is Docker.
The container image is distributed by Portainer via portainer/dev-toolkit, checkout DockerHub for more details on the tags/versions: https://hub.docker.com/repository/docker/portainer/dev-toolkit/tags?page=1&ordering=last_updated
Developers should be able to customize the environment to their liking (I prefer work with zsh as a shell for example), this dev toolkit was designed to be extended.
See the examples/ and user-toolkits folders for a list of examples on how you can customize your dev toolkit.
All you will need is to build it first:
docker buildx build -t my-devkit -f examples/zsh/Dockerfile .
Then you can use the instructions above to run it, just replace the official portainer/dev-toolkit:2024.10 with your image in the devcontainer.json file:
{
"name": "portainer-dev-toolkit",
"image": "my-devkit",
...
}
If you wish to use somebody's toolkit or share yours, have a look at the user-toolkits/ folder!
After opening your project in the dev container, execute the following commands to start a development build.
Install the dependencies and build the client+server first:
make build-all
Run the backend as a process directly:
./dist/portainer --data /tmp/portainer --log-level=DEBUG
Run the client in dev mode if you wish to do changes on the client:
make dev-client
Content type
Image
Digest
sha256:d8e903a7a…
Size
438.4 MB
Last updated
3 days ago
docker pull portainer/dev-toolkit:2026.09Pulls:
258
Last week