Set preferences for Docker devices | Qt Creator Documentation

- Qt Creator Documentation
- Set preferences for Docker devices
- Qt Creator 18.0.2

Configure development tools ◦ Connect iOS devices

# Set preferences for Docker devices

Note: Enable the Docker plugin to use it.

To set preferences for Docker devices:

1. Go to Preferences > Devices > Devices.
2. In Device, select a Docker device.

The following table summarizes the preferences you can set.

Option | Value
--- | ---
Run as outside user | On Linux and macOS, sets the user ID and group ID of the user running Qt Creator in the Docker container. This option is not available on Windows.
Do not modify entry point | Stops Qt Creator from modifying the entry point of the image. Make sure that the entry point of the image does not exit immediately.
Enable flags needed for LLDB | Adds the following flags to the container to allow LLDB to run:
     --cap-add=SYS_PTRACE --security-opt seccomp=unconfined
Mount Command Bridge | Enables communication between Qt Creator and the running container. The Command Bridge is mounted into the container by default. If your Docker server can't access the folder where Qt Creator is installed, mounting may fail. In that case, turn off this option to use a slower workaround.
Network | Configures the network settings of the container.
Extra arguments | Additional arguments to pass to the Docker CLI when starting the container.
Container environment | Environment variables to set in the container.
Paths to mount | Host directories to mount into the container, such as the project directory.
Port mappings | Host-to-container port mappings to set up when starting the container.

You can set paths for development tools for Docker devices. For more information, see Configure development tools.

## Modify entry points

The entry point of a Docker container is specified in the container settings and started as the main process when starting the container. The entry point can be a shell, an SSH server, or another process, for example. By default, Qt Creator modifies the entry point before it starts a container to make sure that the main process is an `sh` shell.

To stop Qt Creator from modifying the entry point, select Do not modify entry point. However, if the entry point you specify is not a shell, Qt Creator cannot start the container.

## Specify paths to mount

Copy your project files into the Docker container or specify paths to them in Paths to mount. Shared mounts are restricted to locations in the host system that can end up in the same absolute location in the Docker container. On Windows, network mounts cannot be used as shared mounts.

The paths in Paths to mount are mapped one-to-one to the Docker container. Select Insert to browse directories to add. Select Delete Line to delete the selected path or Clear to delete all paths.

## Auto-detect kit items

Select Auto-detect Kit Items to find kit items and create kits for the Docker device. You can search for kit items in the device's PATH or in the specified directories.

In Search locations, select:

- Search in PATH to find kit items in PATH.
- Search in Selected Directories to find kit items in the selected directories.
- Search in PATH and Additional Directories to find kit items in the PATH and in the selected directories.

When searching in directories, enter a semicolon-separated list of directory paths in the Docker image to scan for kit entries.

To list the automatically detected kit items, select List Auto-Detected Kit Items. To remove them, select Remove Auto-Detected Kit Items.

See also Enable and disable plugins, How To: Develop for Docker, and How To: Manage Kits.

Configure development tools ◦ Connect iOS devices