Local Docker Container

CodeArts Agent IDE supports local Docker container connections. This function uses locally running Docker containers as development environment backends, enabling users to efficiently write, debug, and run code in containers via remote connections within a unified IDE interface. With this function, users can manage and develop code inside containers end-to-end without frequently switching terminals or manually entering the container.

Figure 1 Remotely connecting to a local docker container
Click to enlarge

Constraints

**Table 1** Constraints
Category	Description
Docker	Docker Desktop has been successfully deployed in the local Windows environment and is running properly.
OS version	glibc: 2.18 or later # Check the glibc version. ldd --version glibcxx: 3.4.22 or later # Check the glibcxx version. # Ubuntu strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 \| grep GLIBCXX # openEuler strings /lib64/libstdc++.so.6 \| grep GLIBCXX
Webpage preview	Direct opening of the browser for preview via the file:/// protocol is currently not supported.

Connecting to a Local Docker Container

Log in to CodeArts Agent IDE as instructed in Quick Start.
Click in the left menu bar of the IDE to open the remote development page.
Under Docker containers, CodeArts Agent IDE automatically detects and identifies existing Docker containers in the current system.
Hover the cursor over the Docker container to be connected, click , and wait until the connection is complete.

Before performing the connection operation, ensure that the Docker container is enabled. If the Docker container is not enabled, hover the cursor over the container and click to enable it.
After the connection is successful, click Open Folder in the explorer, browse and select the target folder on the Docker container, and click OK to open it in the current window.

Managing Docker Container Connections

**Table 2** Managing Docker container connections
Operation	Instruction
Disabling a remote connection	In the remote development of CodeArts Agent IDE, hover the cursor over the connected Docker container and click to disable it. After the connection is disabled, you can click to reconnect.
Renaming	In the remote development of CodeArts Agent IDE, hover the cursor over the connected Docker container and click to change the name of the remote connection.
Displaying the remote host process	In the remote development of CodeArts Agent IDE, hover the cursor over the connected Docker container and click to view the process information of the remote host.

Other Operations

**Table 3** Other operations
Operation	Description
	Reloads the current Docker container list or status.
	Expands all hierarchical levels under Docker containers and unfolds all subnodes, allowing users to quickly browse and manage a large number of connection items.
	Collapses all expanded Docker containers, reducing the number of displayed levels and improving the readability and operation efficiency of the interface.
Displaying or hiding detected CodeArts projects	Controls whether to display remote projects and connection information automatically detected by the IDE and related to CodeArts.
Synchronizing information with local extensions	Triggers a synchronization of the current Docker container configuration to a local extension. This is typically used to ensure that extensions can properly recognize and use the latest Docker container details, preventing connection issues caused by inconsistent configurations and improving stability and consistency.
Showing connection logs	Views detailed Docker container logs. When a connection fails or behaves abnormally, you can use these logs to troubleshoot issues and locate root causes.
Setting log levels	Adjusts the verbosity level of Docker container logs, such as Trace, Debug, and Info (default: Info).
Opening help documentation	Opens the official help documentation to access detailed guides on Docker container configuration and basic operations.