https://github.com/pgschk/alpine-toolkit

An alpine docker image with some debugging tools
https://github.com/pgschk/alpine-toolkit

alpine container-image debugging-tool docker-image toolkit

Last synced: 5 months ago
JSON representation

An alpine docker image with some debugging tools

• Host: GitHub
• URL: https://github.com/pgschk/alpine-toolkit
• Owner: pgschk
• License: mit
• Created: 2024-01-04T22:15:07.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-11-18T18:33:18.000Z (7 months ago)
• Last Synced: 2025-11-18T20:10:32.757Z (7 months ago)
• Topics: alpine, container-image, debugging-tool, docker-image, toolkit
• Language: Dockerfile
• Homepage:
• Size: 48.8 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
[![Container CI](https://github.com/pgschk/alpine-toolkit/actions/workflows/publish-container.yml/badge.svg)](https://github.com/pgschk/alpine-toolkit/actions/workflows/publish-container.yml)

![GitHub release (with filter)](https://img.shields.io/github/v/release/pgschk/alpine-toolkit)

# Alpine Toolkit

An alpine container with some debugging tools installed. For every release there is a normal container that includes only the essentials, as well as an extended container, which includes more tools at the cost of size.

## Included tools

The following tools are currently included in Docker image `pgschk/alpine-toolkit:latest`:

- telnet

- netcat

- curl

- tcpdump

## Extended images

Additionally there is an extended image, which includes more tools at the cost of being larger.

The image `pgschk/alpine-toolkit:latest-extended` additionally includes:

- mosquitto-clients (mosquitto_sub, mosquitto_pub)

- strace

## Add additional tools

To add more packages, build the container with the build argument "EXTRA_PACKAGES" set to a list of [Alpine packages](https://pkgs.alpinelinux.org/packages):

```sh

docker buildx build --build-arg EXTRA_PACKAGES="mosquitto-clients" -t alpine-toolkit:local .

```

## Use as Kubernetes debug

You can use `kubectl debug` to attach the container to an existing pod to get access to the debugging tools.

### Example

We will assume that our pod is named "my-pod" with a container "my-container", which we want to attach to:

```sh

kubectl debug -it my-pod --image=pgschk/alpine-toolkit --target=mycontainer

```