Add a new container
Last updated
Last updated
Select Containers from the menu then click Add container.
Configure the container settings as required.
When using Docker Hub you can use the Search button to search for the image you have entered, and ensure that you have the correct name and tag. Portainer also displays the number of pulls remaining for your Docker Hub account when using an anonymous account.
Alternatively you can switch to advanced mode to manually enter registry and image details. This is useful if you want to do a one-off container deployment from a registry that isn't configured within Portainer.
Toggle Create a container webhook on to create a webhook for the container. You can send a POST request to this endpoint to automate pulling the most up-to-date image and re-deploy your container.
Once complete, set any advanced options (see below) then click Deploy the container. If successful your container will be shown in the container list.
Choose from a range of options to customize the deployment.
Field/Option | Overview |
---|---|
Field/Option | Overview |
---|---|
Field/Option | Overview |
---|---|
Name
Give the container a descriptive name.
Registry
Select the registry that contains the image that you want to use for your container.
Image
Enter the name of the image you want to use.
Always pull the image
Toggle on to enforce pulling the image from the registry instead of using the locally cached copy (if you have used the image previously).
Publish all exposed network ports to random host ports
Toggle on to allow Portainer to randomly assign ports on the host to the exposed ports in the container.
Manual network port publishing
Click publish a new network port to create manual port mappings for the container.
Auto remove
Toggle this option on to automatically remove the container once it exits. This is useful if you want to run a container only once.