Skip to content

Docker Containers

Licobox includes a Docker engine for managing containers, with support such as port forwarding and bind mounts/volumes.

Docker CLI

Licobox runs on Docker Engine and is fully compatible with the Docker CLI. It supports port forwarding, bind mounts, and volumes.

Docker Context

Licobox will automatically use licobox context when it starts.

To maintain compatibility with other tools that rely on /var/run/docker.sock, run the following command:

shell
licobox config-docker set-docker-socket

Emulate amd64 container

Licobox uses Rosetta to emulate running container built for amd64 CPU. You can also build image for amd64 CPU.

shell
# Run an amd64 container
docker run -it --rm --platform linux/amd64 busybox

# Build image for amd64
docker build --platform linux/amd64 .

If Rosetta is not installed, you can run the following command:

shell
/usr/sbin/softwareupdate --install-rosetta

SSH Agent Forwarding

SSH agent forwarding can be started using the following:

shell
docker run -it --rm \
    -v /run/host-services/ssh-auth.sock:/run/host-services/ssh-auth.sock \
    -e SSH_AUTH_SOCK=/run/host-services/ssh-auth.sock \
    alpine

Or with Docker Compose:

yaml
services:
 web:
   image: alpine
   volumes:
     - type: bind
       source: /run/host-services/ssh-auth.sock
       target: /run/host-services/ssh-auth.sock
   environment:
     - SSH_AUTH_SOCK=/run/host-services/ssh-auth.sock