Knowledge Center

Container

In Container, you can operate and manage your containers. Creating a container requires images. If you don’t have any images, you can go to the Registry page to download the images uploaded by open-source developers.

To create a container:

  1. Click Create to start the creation wizard.
  2. Configure the general settings:
    • Image: Select an image for this container.
    • Container name: Specify a name for this container.
    • Choose whether to enable resource limitation, auto-restart, and a web portal via Web Station.
  3. Configure the advanced settings:
    • Port: Add this container's local ports. To find out which ports are exposed ports, check the image's Dockerfile.
    • Volume: Specify the mount path for this container.
    • Environment: Manage the container's environment variables. The required variables can usually be found in the Dockerfile.
    • Links: Link the container to other containers to allow multiple containers to discover each other and transfer information safely.
    • Capability:
      • Execute container using high privilege: Run the container as a privileged container.
      • Configure capabilities: A privileged container's capabilities cannot be customized.
    • Network: Decide on the container's network mode. You can select one or more bridge networks to connect to or use the same network as the Docker Host (DSM).
    • Execution command: Set the commands you want to run in the container.
    • Link: Add containers that are linked to this container.
  4. Confirm the summary of your settings and click Done to finish.
  5. Choose whether to start the project after the wizard is finished.

Note:

  • If you cannot create a container with images from Docker Hub even if you have made sure the settings are correct, try using a different image because Docker Hub contains customized images uploaded by developers, and sometimes the image quality cannot be guaranteed.
  • When you configure the container ports, make sure to select the ports that are not used by other DSM services. A port conflict may cause service errors. Check this FAQ article to learn more about the ports DSM uses.
  • The default time zone of most containers is UTC. You can change a container's time zone by setting the environment variable "TZ". Visit here to check the list of time zones of the tz database.

To perform operations on a container:

  1. Select a desired container.
  2. Click on Action or right-click on the container:
    • Start: Start the container.
    • Stop: Stop the container.
    • Restart: Restart the container.
    • Delete: Delete all data in the container.
    • Details:
      • General: General information of the container.
      • Statistics: Container resource usage, including CPU, Memory, and Network.
      • Log: The activity logs of the container. You can search for specific log entries or click Export to export the logs. Log export is available in both HTML and CSV formats.
      • Settings: The configuration of the container.
    • Open Terminal: The terminal interface of the container. This is only available when your web browser supports WebSockets.
    • Import: Import settings of another container file to the container.
    • Export: Export the container or both the container and the settings to your Synology NAS or local computer.