Connect to Docker
Some Porter commands connect to a Docker engine in order to build, push, and pull the bundle image. Learn how to configure Porter to connect with various Docker configurations.
- Connect to the local Docker engine
- Connect to a remote Docker engine
- Additional Supported Docker Settings
Connect to the local Docker engine
Porter defaults to connecting to the local Docker engine and no additional configuration is required.
Try it out by running porter install --reference ghcr.io/getporter/examples/porter-hello:v0.2.0
.
Connect to a remote Docker engine
Porter uses the standard Docker environment variables to connect to a remote Docker engine:
- DOCKER_HOST: The host name and port of the remote Docker engine.
- DOCKER_CERT_PATH: The local directory containing the certificates necessary to connect to the remote Docker engine. By default, Porter looks for ca.pem, cert.pem, key.pem in ~/.docker/certs.
- DOCKER_TLS_VERIFY: When this environment variable is set, Porter will use TLS to connect to the remote Docker engine. If the value is not true, the TLS certificates will not be verified.
Below is an example of how to set and use these environment variables.
Bash
export DOCKER_HOST="example.com:2376"
export DOCKER_TLS_VERIFY="true"
export DOCKER_CERT_PATH="/home/me/example-certs"
porter install --reference ghcr.io/getporter/examples/porter-hello:v0.2.0
Powershell
$env:DOCKER_HOST="example.com:2376"
$env:DOCKER_TLS_VERIFY="true"
$env:DOCKER_CERT_PATH="C:\Users\me\example-certs"
porter install --reference ghcr.io/getporter/examples/porter-hello:v0.2.0
Additional Supported Docker Settings
Porter supports additional Docker environment variables that may be useful to you:
- DOCKER_NETWORK: Specifies the name of an existing Docker network that Porter should use when running Docker containers.
- DOCKER_CONTEXT: Specifies the name of an existing Docker context that Porter should use when running Docker containers.