Add a Docker Standalone environment
When connecting a Docker Standalone host to Portainer, there are two methods you can use. You can either connect directly to the Docker API via TCP, or you can install the Portainer Agent on the Docker Standalone host and connect via the agent.
Connecting via the Docker API
Before you begin, you will need to ensure that your Docker instance is configured to admit remote connections. To learn how to do this, refer to Docker's own documentation. Once Docker is configured, you will be able to connect either with or without TLS.
From the menu select Environments then click Add environment.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3335897979-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUeb1lPrWdn7TlqnXoAAC%252Fuploads%252FWh8KulWS8E2w7ThjRrbS%252F2.16-environments-add.gif%3Falt%3Dmedia%26token%3D07af1b76-73e1-4119-84dd-8584928b18b6&width=768&dpr=4&quality=100&sign=ae7c30f6&sv=1)
Next, select Docker Standalone as the environment type then click Start Wizard. Select the API option and your platform, then enter the environment details using the table below as a guide:
Field/Option | Overview |
---|---|
Name | Give the environment a descriptive name. |
Docker API URL | Enter the DNS name or IP address to connect to the Docker host along with the port. When connecting without TLS, the default port is |
TLS | Toggle this option on if you wish to use TLS. Toggle it off if you don't want to use TLS. |
Skip Certification Verification | Toggle this option on to skip the verification of the TLS certificate used by the Docker API. If this option is off, the below fields will not appear. |
TLS CA certificate | Select your CA certificate. |
TLS certificate | Select your certificate. |
TLS key | Select the key that matches the certificate. |
Portainer expects TLS certificates and keys to be in PEM format.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3335897979-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUeb1lPrWdn7TlqnXoAAC%252Fuploads%252FqY2wLNhdbTVGvaG5afu1%252F2.16-environments-add-docker-api.png%3Falt%3Dmedia%26token%3Dc375b5aa-b014-4ccf-a143-4fee1f03aa89&width=768&dpr=4&quality=100&sign=8a57a75c&sv=1)
As an optional step you can expand the More settings section to add GPUs to your environment, and to categorize the environment by adding it to a group or tagging it for better searchability.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3335897979-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUeb1lPrWdn7TlqnXoAAC%252Fuploads%252FcssxQ2J74NEpVDHtaj0I%252F2.15-docker_api_more_settings.png%3Falt%3Dmedia%26token%3D9cd8d1c5-168f-41ac-acef-0dfb6f16b2f3&width=768&dpr=4&quality=100&sign=fb7ea320&sv=1)
When you're ready, click Connect. If you have other environments to configure click Next to proceed, otherwise click Close to return to the list of environments.
Connecting via the Portainer Agent
From the menu select Environments then click Add environment.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3335897979-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUeb1lPrWdn7TlqnXoAAC%252Fuploads%252FWh8KulWS8E2w7ThjRrbS%252F2.16-environments-add.gif%3Falt%3Dmedia%26token%3D07af1b76-73e1-4119-84dd-8584928b18b6&width=768&dpr=4&quality=100&sign=ae7c30f6&sv=1)
Next, select Docker Standalone as the environment type then click Start Wizard. Select the Agent option, then your environment type. Copy the command for your environment type and run it on your Docker Standalone instance.
Once the Agent has been deployed, enter the environment details using the table below as a guide:
Field/Option | Overview |
---|---|
Name | Give the environment a descriptive name. |
Environment address | Enter the DNS name or IP address to connect to the Portainer Agent along with the port (the default port is |
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3335897979-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUeb1lPrWdn7TlqnXoAAC%252Fuploads%252F9giLhr7xP5BsV3zwiNxp%252F2.16-environments-add-docker-agent.png%3Falt%3Dmedia%26token%3D3700c38e-9d80-4e08-9fc4-87ca60fa392b&width=768&dpr=4&quality=100&sign=9f6032c7&sv=1)
As an optional step you can expand the More settings section to add GPUs to your environment, and to categorize the environment by adding it to a group or tagging it for better searchability.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3335897979-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUeb1lPrWdn7TlqnXoAAC%252Fuploads%252FcssxQ2J74NEpVDHtaj0I%252F2.15-docker_api_more_settings.png%3Falt%3Dmedia%26token%3D9cd8d1c5-168f-41ac-acef-0dfb6f16b2f3&width=768&dpr=4&quality=100&sign=fb7ea320&sv=1)
When you're ready, click Connect. If you have other environments to configure click Next to proceed, otherwise click Close to return to the list of environments.
Last updated