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.

daemon.json configuration

You can configure the daemon through a JSON configuration file located at ~/.licobox/docker/daemon.json.

This file allows you to define daemon settings such as registries, insecure registries, and other related options.

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:

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.

# 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:

/usr/sbin/softwareupdate --install-rosetta

SSH Agent Forwarding

SSH agent forwarding can be started using the following:

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:

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