Installation

Netshoot is distributed as a public Docker image, making it incredibly easy to use.

Pulling the Docker Image

The recommended way to get Netshoot is to pull the latest image from Docker Hub or the GitHub Container Registry.

Docker Hub

docker pull nicolaka/netshoot

GitHub Container Registry (GHCR)

docker pull ghcr.io/nicolaka/netshoot

The image is multi-platform, supporting both linux/amd64 and linux/arm64.

Building from Source

If you need to customize the image or want to build it yourself, you can do so from the source code.

1. Clone the repository:

   git clone https://github.com/nicolaka/netshoot.git
   cd netshoot

2. Build the image using the Makefile:

   The project includes a Makefile that simplifies the build process. You can build for a specific architecture or for all supported platforms using Docker Buildx.

   • Build for all platforms (amd64 and arm64):

     This requires Docker Buildx to be set up.

     make build-all

   • Build for amd64 (x86_64) only:

     make build-x86

   • Build for arm64 only:

     make build-arm64

After a successful build, the image nicolaka/netshoot:0.1 (or the version specified in the Makefile) will be available in your local Docker image cache.