Skip to main content
Version: TOS 7

Docker Manager

Docker Manager is a Docker management tool with a graphical interface that provides a great user experience. Docker Manager integrates an image registry and implements rich features through a graphical interface, such as image search, download, and container installation and configuration. Millions of images on Docker Hub offer various possibilities for your TNAS to meet your business needs.

Note

To use the Docker Manager application, please install Docker engine first.

Overview

On the Overview page, you can quickly grasp the real-time status of projects and containers to ensure stable service operation. The page also intuitively displays the resource usage of running projects and containers at a glance.

The Overview page contains the following core information:

  • Docker Engine Status: Shows whether Docker Engine is installed and enabled; if not installed or not enabled, the page will prompt "Docker Engine is not installed or not enabled";
  • CPU Usage: Displays the total Docker CPU usage and percentage;
  • RAM Usage: Displays the total Docker memory usage and utilization rate;
  • Resource Statistics Chart: Graphically displays CPU and memory usage trends;
  • Container Running Overview: Shows the count of running/stopped containers; provides prominent indicators when containers are running abnormally;
  • Image Statistics: Displays the total number of local images.

Projects

Through projects, you can easily define a multi-container application with a single configuration file (Docker-compose.yml), and create and start all services from the YML file configuration with just one command.

Managing Projects

On the Projects page, you can perform the following operations on projects:

  • Add project: Add a new project;
  • Start/Stop: Start/stop the selected project;
  • Restart: Restart the selected project;
  • Edit: Edit the selected project;
  • Delete: Delete the selected project;
  • Force Stop: Force stop the selected project;
  • Clean: Stop and delete all service containers, networks, images, and volumes;
  • Build: Rebuild the project through the project's YAML configuration file;

Creating a Project

To create a project in the Projects feature:

  1. In the Docker Manager application interface, click "Projects" in the left navigation bar;
  2. Click the "Add" icon in the upper right corner, or the "Add Now" button on the page to open the Create Project dialog;
  3. Set the project name, project path, and configuration file (Docker-compose.yml) in sequence There are three ways to set the configuration file: • Local TNAS — Select a local TNAS file to configure. • Your Computer — Upload a configuration file from your computer. • Create YAML File — Open the editor to create a docker-compose.yml.
  4. Validate YAML.
  5. After validation passes, click the Apply button.
Note
  • Validating YAML will check the content and format of the docker-compose.yml in the editor. When the content is empty or the format is incorrect, the "Apply" button cannot be clicked. Please modify your docker-compose.yml file according to the prompt.
  • If the Compose configuration file is deleted, the page will display a prompt.

How to quickly check the reason for project creation failure?

When a project creation failure is observed during the project creation process, you can click the "Creation Failed" project status to view the error log.

Containers

A container is a running instance of a Docker image and the dynamic representation of an image. It can be started, paused, stopped, and deleted. Creating a container requires an image. If you do not have any images, you can go to the Registry page to download images uploaded by open-source developers.

Managing Containers

On the Containers page, you can perform the following operations on containers:

  • Add: Select an image to create a container;
  • Start/Stop: Start/stop a container;
  • Restart: Restart a running container;
  • Edit: Edit the container's configuration;
  • Delete: Delete the selected container;
  • Force Stop: Force stop a running container;
  • Duplicate Container: Configure a new container by duplicating the container's configuration (only configuration is duplicated, not images and data; ports are automatically remapped);
  • Export: Export the selected container as a .tar file; supports "Export Container" and "Export Container Settings Only" modes;
  • Import: Select an importable file and configure the container based on the file;
  • Processes: Running status of commands executed inside the container;
  • Logs: Logs generated by container operation;
  • Terminal: Container terminal interface (bash).
  • Send to Desktop: Create a container shortcut on the TOS desktop; supports uploading custom icons (.jpg/.png, size ≤ 8MB).
  • Access URL: View the container's access URL.

Creating a Container

To create a container in the Docker Manager application:

  1. In the Docker Manager application interface, click "Images" in the left navigation bar;
  2. Click the "Start" icon in the upper right corner to open the Create Container dialog;

Step 1: Basic Information

  • Image Selection: Select from local images;
  • Repository Address: Optional custom repository address (with username/password authentication);
  • Container Name: Supports lowercase letters, numbers, hyphens -, and underscores _; cannot start with - or _.

Step 2: Network & Ports

  • Network Mode: host mode (uses the host IP and ports) or bridge mode (virtual bridge, independent IP segment such as 172.17.x.x);
  • Add Port: Configure local port + container port + protocol; supports add/edit/delete; error prompt when port is occupied.

Step 3: Volumes

  • Set container data storage path (host directory → container directory) to back up container data to the host;
  • Read/Write Permission: Default read-write, can be switched to read-only (container can only read);
  • Tip: "Even if the container is deleted, the data will not be deleted."

Step 4: Environment Variables

  • Set environment variables for the container (variable name + variable value); supports add/edit/delete.

Step 5: Container Links

  • Create connections with other containers to enable secure communication between multiple containers; supports setting aliases.

Step 6: Execution Configuration

  • Privileged Execution: When enabled, the container runs with ROOT privileges (privileged container);
  • CPU Priority: Low/Medium/High three-level selection;
  • Memory Limit: Set the maximum memory usage for the container;
  • Auto-start on Boot: Automatically start the container after NAS restart or Docker Engine restart;
  • Bandwidth Limit: When enabled, limits the container's network bandwidth;
  • Custom Capabilities: Add/remove Linux Capabilities;
  • Entrypoint: Customize the container entry command;
  • CMD: Customize the container start command.
  1. Confirm settings and click "OK" to complete the setup.
Note
  1. If you have ensured the settings are correct but still cannot successfully create a container using a Docker Hub image, try using a different image, as Docker Hub contains custom images uploaded by different developers, and image quality cannot always be guaranteed.
  2. When configuring container ports, please select port numbers different from those used by other services to avoid service errors caused by port conflicts.
  3. The default timezone for most containers is UTC. You can set the environment variable "TZ" to change the container's timezone. Please visit here to view the timezone list in the timezone database.

Images

A Docker image is a special file system that, in addition to providing the programs, libraries, resources, and configuration files needed for container runtime, also contains some configuration parameters prepared for runtime. It is the foundation for creating and running Docker containers.

Local Images

Lists images that have been downloaded to TNAS locally. You can manage all downloaded images through the image feature and use images to create containers.

Managing Local Images

On the Local Images page, you can perform the following operations on local images:

  • Start: Start the selected image and configure the corresponding container;
  • Import: Import images stored on your computer or NAS;
  • Export: Export the selected image to a NAS folder;
  • Delete: Delete the selected image.

Registry

Syncs millions of image repositories from Docker Hub. In the Registry, you can:

  • Add Registry: Add a new image repository source with support for setting the repository address, username, and password authentication;
  • Edit Registry: Modify registered repository information;
  • Delete Registry: Remove custom repositories (the system default Docker Hub cannot be deleted);
  • Enable/Disable Registry: Toggle the registry's usage status;
  • SSL Certificate Trust: Trust repositories with self-signed SSL certificates.

Accelerator Configuration

Image accelerators are used to speed up downloading Docker Hub images:

  • Enable Registry Mirror: Enable the Docker Hub image accelerator;
  • Accelerator URL: Configure the image acceleration address (such as Alibaba Cloud image acceleration, USTC mirror source, etc.);
  • Modification Notice: Modifying the accelerator configuration will restart Docker Engine, interrupting running tasks (such as creating containers or projects, downloading images, etc.).

Network

The Network module is used to manage Docker container networks, supporting custom network creation and configuration.

Managing Networks

On the Network page, you can perform the following operations on networks:

  • Add Network: Custom create a new Docker network;
  • Delete: Delete the selected custom network;
  • Settings/Details: View network details and manage containers connected to the selected network.

Creating a Network

The following items can be configured when creating a network:

Configuration ItemDescription
Network NameSupports letters, numbers, hyphens - _
DriverDefault bridge (supports custom drivers)
IP Configuration ModeAutomatic (DHCP) / Manual
IPv4 SubnetCIDR format, e.g. 172.20.0.0/16
IPv4 Gatewaye.g. 172.20.0.1
IPv4 IP RangeCIDR format, e.g. 172.20.10.128/25
IPv6 SubnetCIDR format, e.g. fd80:ac8::/48
IPv6 Gatewaye.g. fd80:ac8::1
IPv6 RangeCIDR format, e.g. fd80:ac8::/64
Disable IP MasqueradingDisable IP Masquerading
Assign ContainersImmediately add existing containers to this network

Logs

Lists all operation records executed in the Docker Manager application. Logs can be exported and managed.

Managing Logs

On the Logs page, you can view logs for all tasks, select specific tasks to view their logs, and configure the following settings for logs:

  1. Search: Search for events;
  2. Refresh: Refresh the logs;
  3. Export: Export logs;
  4. Delete: Delete logs — you can delete all logs or specified logs;
  5. Settings: Set log retention policies; logs that do not comply with the policies will be automatically deleted.