Debug Container

Licobox Debug is a command that helps you debug your container while keeping the image slim. Licobox Debug includes a set of utilities that let you inspect and troubleshoot any containers with lacking shell command or debugging tools.

Licobox Debug has a set of common utilities such as coreutils, htop, curl, snitch, etc., allowing you to inspect and troubleshoot running containers, including shim or distroless containers. You can also modify files inside a running container and install additional packages without modifying the container.

Usage

Start Licobox Debug from a terminal:

licobox debug "container_name_or_id"

Note

The container being debugged is mounted at the /container path rather than the root /. When you start debugging, the container’s working directory is automatically set to /container.

Examples

Run an nginx container:

docker run -d --name nginx-app -p 8080:80 nginx

Once the nginx is running by checking http://localhost:8080, start get into debug:

licobox debug "nginx-app"

Manage Packages

You can also install additional packages using pkgbox. For example, to install curl:

pkgbox install curl

Installed packages are persisted inside Licobox Debug. Installing or uninstalling packages will not modify the container.

To search available packages you can use pkgbox search curl.