Configure a container

Required configuration items

The following configuration options are completed automatically if Create Configuration was selected when the container was created. See Upload a new LXC container for details:
- Name of the container.
- Enable the container.
- Whether or not the container should use the device's system libraries.
Determine whether or not the device should including virtual networking capabilities.

Additional configuration items

If virtual networking is enabled:
- The bridge to be used to provide network connectivity.
- A static IP address for the container.
- The network gateway.
Serial ports on the device that the container will have access to.

 Web

Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
Access the device configuration:
Remote Manager:
1. Locate your device as described in Use Digi Remote Manager to view and manage your device.
2. Click the Device ID.
3. Click Settings.
4. Click to expand Config.
Local Web UI:
1. On the menu, click System. Under Configuration, click Device Configuration.
  The Configuration window is displayed.
Click System > Containers.
For Add Container, type the name of the container and click .
The Container configuration window is displayed.
New containers are enabled by default. To disable, toggle off Enable.
Clone host system libraries is enabled by default. This allows the container to use the device's system libraries.
Enable Virtual Network if the container should have network access:
1. Select a Network Bridge Device that will provide access to the container.
2. (Optional) Enter a static IP Address and netmask for the container. This must be a valid IP address for the bridge, or, if left blank, a DHCP server can assign the container an IP address.
3. (Optional) For Gateway, type the IP address of the network gateway.
Enable Start on boot to configure the container to start when the system boots.
1. For Restart timeout, set the amount of time to wait before restarting the container, if the container ever stops. The default timeout of 0s means that if the container stops, it will not be restarted.
  Allowed values are any number of weeks, days, hours, minutes, or seconds, and take the format number{w|d|h|m|s}.
  For example, to set Restart timeout to ten minutes, enter 10m or 600s.
(Optional) Type any Optional parameters for the container. Parameters are in the format accepted by the lxc utility.
(Optional) Type a Working directory to configure an initial working directory for the container. The directory is an absolute path within the container and must begin with "/". The default is /.
(Optional) Click to expand Mounted directories to configure system directories that will be mounted inside the container. Any mounted directories need to be accessible to a non-privileged user.
1. For Add Directory, click .
2. For Directory, type the pathname of the directory to be mounted. The leading slash should be removed, so for example to mount the /opt directory, type opt.
(Optional) Click to expand Serial ports to assign serial ports that the container will have access to.
1. For Add Port, click .
2. For Port, select the serial port.
Click Apply to save the configuration and apply the change.

 Command line

Select the device in Remote Manager and click Actions > Open Console, or log into the EX15 local command line as a user with full Admin access rights.
Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.
At the command line, type config to enter configuration mode:
```
> config
(config)>
```
Create a new container:
```
(config)> add system container name
(config system container name)>
```
where name is the
New access points are enabled by default.

New containers are enabled by default. To disable:

(config system container name)> enable false
(config system container name)>

By default, the container will use the device's system libraries. To disable:
```
(config system container name)> dal false
(config system container name)>
```

If the device will use virtual networking:

Enable virtual networking:

(config system container name)> network true
(config system container name)>

Set the network bridge device that will be used to provide network access:

Use the ? to determine the available bridges:

(config system container name)> bridge ?

Network Bridge Device: Containers require a bridge to access the network. Choose
which bridge to connect the container to.
Format:
  lan1
Current value:

(config system container name)>

Set the bridge:

(config system container name)> bridge lan1
(config system container name)>

(Optional) Set the IP address and netmask for the container:

(config system container name)> address IP_address/netmask
(config system container name)>

(Optional) Set the IP address of the network gateway:

(config system container name)> gateway IP_address
(config system container name)>

To configure the container to start when the device boots:
```
(config system container name)> start_on_boot true
(config system container name)>
```
1. Set the amount of time to wait before restarting the container, if the container ever stops:
```
(config system container name)> restart_timeout value
(config system container name)>
```
  where value is any number of weeks, days, hours, minutes, or seconds, and takes the format number{w|d|h|m|s}.
  For example, to set restart_timeout to ten minutes, enter either 10m or 600s:
```
(config system container name)> restart_timeout 600s
(config system container name)> 
```
  The default timeout of 0s means that if the container stops, it will not be restarted.
Type any optional parameters for the container:
```
(config system container name)> args parameters
(config system container name)> 
```
Parameters are in the format accepted by the lxc utility.
(Optional) Set an initial working directory for the container.
```
(config system container name)> workdir /value
(config system container name)> 
```
The directory is an absolute path within the container and must begin with "/". The default is /.
(Optional) Set any system directories that should be mounted inside the container. Any mounted directories need to be accessible to a non-privileged user.
1. Add a system directory to be mounted:
```
(config system container name)> system_dirs directory
(config system container name)> 
```
  where directory is the pathname of the directory to be mounted. The leading slash should be removed, so for example to mount the /opt directory, type opt.
2. Repeat for additional directories.
For Add Directory, click .
1. For Directory, type the pathname of the directory to be mounted. The leading slash should be removed, so for example to mount the /opt directory, type opt.

(Optional) Assign serial ports that the container will have access to:

Determine available serial ports:

(config system container name)> ... serial

Serial

 Additional Configuration
 -------------------------------------------------------------------------------
 port1                     Port 1
 ...

(config system container name)>

Add the port:

(config system container name)> add ports end port1
(config system container name)>

Save the configuration and apply the change.

(config network wireless client new_client)> save
Configuration saved.
>

Type exit to exit the Admin CLI.
Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.