Boxfish

Boxfish is a UI for Docker that runs in a browser.
You can use it to view images and containers running in your Docker platform.

Startup

You can run boxfish with the following command:

docker run -d --rm \
    --name boxfish \
    -p 3000:3000 \
    -v /var/run/docker.sock:/var/run/docker.sock \
    mschnr/boxfish

Boxfish needs to access your docker socket at /var/run/docker.sock.
On some platforms this location can be different.
See the run.sh helper script.

The boxfish image is hosted here: https://hub.docker.com/repository/docker/mschnr/boxfish/general

Docker build

You can build and run the docker image from source instead of pulling from Dockerhub:

# build a docker image
sh build.sh
# run the docker image
sh run.sh

Local developer setup

You can run Boxfish in dev mode outside docker by running the client and server separately.
This assumes you have npm setup:

# Server startup:
cd server
npm i
npm run start

# UI startup:
cd ui
npm i
npm run start

Built with

• Angular
• Tanstack Query
• PrimeNG
• Fastify
• dockerode
• Xterm.js