Custom docker run arguments

ade encapsulates most of the options needed to start and run the Docker container with the correct docker run options. However, a power user of Docker may find certain options missing. ade start allows users to pass additional arguments to docker run.

To pass options, separate them with -- from the preceding ade options. For example, use the following command to mount port 1234 into ade:

ade start -- --publish 127.0.0.1:1234:1234/udp

See https://docs.docker.com/engine/reference/commandline/run/ for more information on docker run.

See Starting ADE with macvlan network configuration and Mounting USB devices in ADE for other examples of ADDARGS.

See The .aderc File for ways to make these options permanent for a project.

Starting ADE with --net=host

The Docker option --net=host configures the Docker container (and by extension the ADE instance) to share its network stack with the host. This option is useful when trying to debug networking applications; however, the option has been known to cause issues with certain UI applications such as glxgears and rviz. To get the UI applications running, use --privileged in addition to --net=host: e.g

ade start -- --net=host --privileged

Warning: Using --privileged is dangerous since it gives Docker nearly all the same access to the host as processes running outside containers on the host (see the Docker documentation). If it is necessary for the ADE instance to appear as a device on the host’s network, try starting ADE with Macvlan instead (see Starting ADE with macvlan network configuration).