eliasmeireles/docker-remote repository overview

⁠Docker Remote Access with TLS Configuration

This guide explains how to configure a Docker server for secure remote access using TLS.

⁠🔐 TLS Configuration Requirements

To make your Docker server remotely accessible with TLS, use the automated setup script⁠.

⁠Important Note: Common Name (CN) Consistency

During certificate generation, you’ll be prompted for the Common Name (CN) (e.g., docker-server).
This must match the value of DOCKER_REMOTE_HOSTNAME (e.g., DOCKER_REMOTE_HOSTNAME=docker-server).

⁠🛠️ Environment Variables

⁠📜 Certificate Requirements

Ensure your Docker server is TLS-enabled with these certificates:

• ca.pem
• cert.pem
• key.pem
• ca-key.pem

Bind them to the container at runtime:

⁠Basic Setup

docker run --rm -it -d --name docker-remote \
    -e DOCKER_REMOTE_IP_ADDRESS=<SERVER_IP> \
    -v ./.out:/etc/docker/certs.d \
    -v ./tools:/tools \
    eliasmeireles/docker-remote:latest
docker exec -it docker-remote /bin/bash

⁠Custom Configuration (Override All Variables)

docker run --rm -it -d --name docker-remote \
    -e DOCKER_TLS_VERIFY=1 \
    -e DOCKER_REMOTE_HOSTNAME="custom-docker-server" \
    -e DOCKER_HOST="tcp://custom-docker-server:2376" \
    -v /custom/path/certs:/etc/docker/certs.d \
    -v ./tools:/tools \
    eliasmeireles/docker-remote:latest
docker exec -it docker-remote /bin/bash