oosVersion 2.1

Add Container Template

Comprehensive guide to configuring Container templates, storage mounts, importing templates, Registries, and Network Endpoints.

Create or import a template here when the App Store does not have the container template you need. A Container packages a program with its required environment; this page uses Docker containers. A template stores installation settings. After creating it, install it from the App Store to create an application you can operate.

Before You Start

Obtain the image name, version tag, resource requirements, and any required environment variables, ports, storage paths, and device settings from the application provider. Do not guess values for optional items you do not need.

  • Container Registry: The source storing container images. An image contains the program and environment files used to create a container. If the source is not configured yet, follow “Adding a Container Registry” below first.
  • Image Tag: A label selecting an image version. The existing default is latest; confirm which tag your application requires.
  • Network Endpoint: The container's network connection settings. Decide where it needs to connect and who may connect to it before choosing a mode. See the field descriptions below for restrictions.

Adding a Container Template

  1. Go to the Application > Template > Container page.
  2. Click the Add Template icon.

Container template list and add button

  1. Type the App Name.
  2. Select the Container Registry.
  3. Type the Image Name.
  4. Type the Image Tag (defaults to latest).
  5. Select the Network Endpoint.
  6. Choose the Resource Limitation.
  7. Configure Environment Variables (setting names and values passed to the program) as required by the application.
  8. Click Upload App Icon to add an icon for the application.
  9. Enter an App Description.
  10. (Optional) Configure Port Binding (port mapping): Add single ports or port ranges according to Docker requirements to map the device's external service ports to ports inside the container.
  11. (Optional) Configure Volumes (storage): Add storage paths to keep container data as required by Docker.
  12. (Optional) Configure Labels (identifying tags): Add names and values for identification and management as required by Docker.
  13. (Optional) Configure Commands (startup instructions): Enter commands to run inside the container as required by Docker.
  14. (Optional) Configure Devices (device mappings): Select the hardware devices the container needs as required by Docker.

Add Container template detailed setup screen

Note: “Device” lists all devices under /dev (the system's device path), including USB devices and serial ports. Select the devices to mount according to the application's requirements.

The service section in the screenshot also has a Service Name field for identifying the service. Fill it in for the service you are creating.

  1. If using Docker Compose (a way to manage multiple container services with a set of settings), add more services and repeat steps 5 through 16 for each service.
  2. Click the Apply button.
  3. Go to Application > App Store and confirm that the new template appears. Then follow Install APPs to install it.

Using an External USB Drive for a Container

To use external storage, first identify the target disk, then complete device mapping and manual mounting. Mounting makes the disk available at a path inside the container. Console is a terminal where you enter text commands.

  1. Select the external hard disk.
  2. Click Apply.

External USB drive mapping and mount setup

  1. Navigate to Application > Information > Container > Action > Console to mount the disk using command-line commands.

This page does not provide a mount command suitable for every disk. If you are unfamiliar with the command line, confirm the disk, target path, and commands with your administrator rather than guessing. Afterward, check that the container can access the disk at the intended path. Selecting the disk and applying alone does not complete the manual mounting step above.


Importing an Existing Template

Use import when you already have an App Template file. Prepare the file, name, description, and icon first.

  1. Go to Application > Template > Container > Import Template.
  2. Type the App Name.
  3. Type the App Description.
  4. Browse and select the App Template file.
  5. Upload the App Icon.
  6. Click the Apply button.

Import Container template page

After importing, confirm the template name and description in the App Store before installing it.


Adding a Container Registry

Use this when an image source is not registered yet. Prepare the registry's server address and, if it requires sign-in, a username and password or token (an access credential).

  1. Go to Application > Template > Container > Registry.
  2. Click the Add button to add a container registry.

Add Container Registry setup page

  1. Type the Registry Name.
  2. Enter Server Address (required). Enable insecure HTTP access is a separate optional toggle. Enable it only after confirming that this source requires unencrypted HTTP access; it is not a prerequisite for entering the server address.
  3. (Optional) Enter the User Name and Password/Token.
  4. Click the Apply button.

Container Registry server information input

After saving, return to template settings and confirm that you can select the new source under Container Registry. During installation, check that the image can be retrieved.


Adding a Network Endpoint

Use this when you need custom container network settings. Network Driver determines how the container network is created. Use the options from your network plan or administrator rather than guessing values.

  1. Go to Application > Template > Container > Network Endpoint.
  2. Click the Add button to create a Network Endpoint.
  3. Type the Network Name.
  4. Select the Network Driver.
  5. Configure Network Driver options.
  6. Click the Apply button.

Add Network Endpoint setup page

After saving, return to the template's Network Endpoint field and confirm that you can select the new entry. Test the required connections and restrictions after installation.


Template Field Descriptions

ItemDescription
App NameDefine a unique name for your application.
Container RegistryA repository for container images (e.g., Docker Hub for public repositories, or private registries).
Image NameThe name of the Docker image to use. An image is a read-only file used to create a container; enter the name supplied by its provider.
Image TagVersion tags to manage container images. Defaults to latest.
Network EndpointSelect container network settings; see the modes and access options below.
Resource LimitationLimits on CPU (processing resources) and memory available to the container. Profiles: Low (0.2 CPU core + 128 MB Memory); Medium (0.5 CPU core + 512 MB Memory); High (2 CPU cores + 2 GB Memory). Note: If container requirements exceed selected resource limits, execution will fail until limits are adjusted.
Environment VariableKey-value pairs used to pass user or application parameters inside containers.
Port BindingConfigures TCP/UDP protocol mappings for public and private ports. Setting public port to 0 assigns a random port.
VolumesFilesystem mounts used to persist container data.
LabelsKey/value metadata: extra identifying information used for organization and management.
CommandsCommands executed upon container startup to initialize services or tasks.
Upload App IconCustom icon image displayed on the App Store page.
App DescriptionBrief summary explaining application features and purpose.

Network Modes and Access Options

Bridge is the default container network mode here. Host mode is available only to the containers specified below. Preserve the connections your application needs while checking who may access it.

Mode or optionPurpose and restrictions
HostReserved for Wireshark or IPsec containers. Others default to Bridge and cannot switch to Host.
BridgeDefault network mode.
Network-restriction(bridge)Bridge mode with access rules, using the options below to manage access.
Allow Internet Access (Select Egress WAN)Allows internet connectivity and selects the outgoing WAN (external network) connection. If the container has a login port, its page access is restricted and managed through Port Mapping.
Allow Controller AccessAllows Controller access to the container.
Allow LAN IP/24 AccessRestricts access to devices in the specified /24 LAN (local network) subnet.
Allow WAN IP AccessRestricts access to specified WAN IP addresses.
NoneApplies no network restrictions; confirm that this matches your access requirements.