Creating a container

In this page you will find important information to guide you through the basic steps of container creation.

Searching and downloading images

In the Registry tab, you are able to import community repository which contains images uploaded by other developers. To help you get started, Synology has included Docker Hub, the largest image repository, as the default repository.

To create a container:

  1. Type in your keyword. (Here we will create Transmission container, a powerful downloader for HTTP, BT, NZB and more).
  2. In the search results, find the one you wish to use. Select it and hit the Download button on the top or simply double click to begin the download.
  3. Go to the Image tab and you should see your image listed.

To view information from an image's official page:

  1. Most of time, the container creation requires some variable settings, and this information is often provided by the developer. Click the icon next to the image title.
  2. This will take you to the information page of the image. You are recommended to read the information and Dockerfile pages before Docker creation, as they provide essential information.
  3. In the Dockerfile page, we can locate the port number required for the container creation. (For example, in the Information page and Dockerfile page of gfjardim/transmission list important information like port number, volume name, and variables you need for the setup.)
  4. Depending on the image maintainer, the level of detail can vary. Sometimes it’s really easy to follow, sometimes the information is not really obvious and may require careful observation.

To create an container via wizard:

  1. In the Container tab, click Launch.
  2. Enter the following information:
  3. Click Advanced settings.
  4. Configure the following settings:
  5. Advanced settings: To enable Auto-restart or not and to create Shortcut on desktop or not.
  6. Port Settings: Enter 9091 for container port as this is the default port advised in the Dockerfile page. Enter any used port on your Synology NAS, which we suppose 8889 here.
  7. Volume:Since Transmission is a downloader, we need a way to access the file downloaded. Without mapping a physical shared folder on Synology NAS, all downloaded files will be stored in the containers and are difficult to retrieve.In Transmission’s Dockerfile page, we saw two volumes in Transmission: /config and /downloads. We will now perform the following to map these two volumes to the physical shared folders on Synology NAS:
  8. Un-check the Read-Only option as we need to grant Transmission permission to write data into the physical drives.

  9. Network:You may choose networks you want to connect to. More details are in Network setting document.
  10. Links:You may choose containers you want to link to. Containers are able to commute with each other by linking each other.
  11. Environment:You may set enviromnent variables and the execute command of a container.
  12. Since accessing Transmission requires credentials, we need to set accounts during the creation. From the Transmission document in Docker Hub, we have figured out the variables are called USERNAME and PASSWORD. Create them in Environment Variables. The variables have to be what mentioned in the image’s help file, the value can be anything of your choice.

  13. Click OK to go back to the general setting page.
  14. Click Next, and then you can see the setting summary.
  15. Check Run this container after the wizard is finished to automatically start the container.
  16. Click Apply to create the container.
  17. If container creation has been successful, you should see a shortcut icon on your desktop.
  18. Click it to launch the application.
  19. Another tab will open and ask for your credentials. Enter the username and password you previously set in the wizard to grant the access.
  20. You will now enter the interface of the container you just created.

Note: