# Set up external agents Use the External nodes menu on the Admin panel to manage your computational agents outside the Datalore infrastructure. All you need is a machine that can connect to your Datalore server with a docker engine on it. Configure a command to run a docker container on this machine using the Admin panel interface, and you can start using it as a manager for external agents with preset selection of available instances. The agents on these external nodes are configured similarly to how you generally configure your agents in Datalore. > **Note: Terminology** > We use the term external node to refer to an agent manager that runs in a docker container separately from the main Datalore instance. ## Workflow Setting up external agents in Datalore comprises the following stages: 1. [Open Datalore ports](#open-datalore-ports) 2. [Configure instances to be used as external agents](#configure-agents) 3. [Create access tokens required for new external nodes](#create-an-access-token) (Unless you already have generated some previously) 4. [Configure a script to run a new external node](#configure-an-external-node) 5. Run the command to launch the container and start using the external agents ## Set up an external node This chapter provides instructions on how to set up an external node that will represent in Datalore a docker container for running computations outside your Datalore infrastructure. Procedure: Open Datalore ports Configure the Datalore server to open ports for external agents. 1. Open the Datalore server configuration file: * Kubernetes installation: `datalore.values.yaml` * Docker installation: `docker-compose.yaml` 2. Expose a new random port and specify it in the EXTERNAL_AGENTS_MANAGER_ENDPOINT_PORT variable. ```YAML services: datalore: ... ports: - "8080:8080" - "8081:8081" - "5050:5050" - "4060:4060" - "3070:3070" expose: [ "8081", "5050", "4060" ] ... volumes: ... - "./agents-config.yaml:/opt/datalore/configs/agents-config.yaml" ... environment: ... EXTERNAL_AGENTS_MANAGER_ENDPOINT_PORT: "3070" ... ``` Procedure: Configure agents Define instances you want to use as external agents. The procedure is similar to how you generally configure agents for [Helm-based](configure-agents-helm-installation.html) and [Docker-based](configure-docker-agents.html) installations. Below are the details that are specific for setting up external agents. Use one of the formats below based on the type of your installation: Docker: In `agents-config.yaml`: ```YAML ... external: dataloreHost: "host.docker.internal" computationPort: 4060 agentsManagerPort: 5050 datalorePort: 8081 instances: - id: external-agent label: "External" description: "External agent" numCPUs: 1 cpuMemoryText: "2 GB" image: jetbrains/datalore-agent:2026.3 requests: cpus: 1 memory: "2G" limits: cpus: 2 memory: "4G" ``` Kubernetes: In `datalore.values.yaml`: ```YAML agentsConfig: external: dataloreHost: "host.docker.internal" computationPort: 4060 agentsManagerPort: 5050 datalorePort: 8081 instances: - id: external-agent label: "External" description: "External agent" numCPUs: 1 cpuMemoryText: "2 GB" image: jetbrains/datalore-agent:2026.3 requests: cpus: 1 memory: "2G" limits: cpus: 2 memory: "4G" ``` Follow the steps below to configure resource consumption for each instance. 1. Configure CPU and memory consumption for each instance. Example You expect agents to be idle 75% of the time. At the same time, you do not want agents to consume more than 2 CPUs and 4 GB at a peak. So, you set the maximum available amount (`limits:`) as 2 CPU and 4 GB and minimum (`requests:` as 25% of those values: 0.5 CPU and 1 GB. ```YAML instances: - id: external-agent ... limits: cpus: 2 memory: "4G" requests: cpus: 0.5 memory: "1G" ``` 2. Define how many GPUs each instance consumes: ```YAML external: ... instances: - id: external-agent ... requests: ... gpu: 1 ... ``` > **Note:** > A GPU machine can only be used exclusively, by one notebook at a time. 3. Define tags to configure whether the agent can be started by an external node, which has its own set of tags. An external node must have all the tags of an agent in order to start it. If no tags are provided for an agent, it can be started by any external node. Example You have a number of machines with GPUs and a few more machines without. You want your GPU machines reserved only for GPU agents: you do not want CPU-only agents to run on GPU machines. For this purpose, you mark CPU-only machines with the tag ‘cpu’, and GPU machines with the tag ‘gpu’. Then, you assign the ‘cpu’ tag to CPU-only agents and the ‘gpu’ tag to GPU agents. Also, you could have some very powerful machines with some GPUs, and you want to use those powerful machines both for CPU-only and GPU agents. In that case, you mark these machines with both tags. The format for assigning tags is presented in the example below. ```YAML external: ... instances: - id: external-agent ... tags: - cpu ``` Procedure: Create an access token Create an access token required to configure a script for a docker container that you want to use as an external agent manager (referred to as external node in the Admin panel). 1. Click the avatar in the upper right corner of the screen and select Admin panel. 2. From the sidebar of the Admin panel, select External nodes. > **Tip:** > The sidebar of the panel is resizable: you can collapse/expand it using the icon in its upper right corner or drag the resize handle that appears when hovering over the sidebar's right border. 3. In the External nodes menu, switch to the Access tokens tab. ![Access tokens tab](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/tokens.png) 4. Click the New access token button. This will open the dialog under the same title. 5. In the New access token dialog, provide a name for the new access token and click the Generate button. ![Generating access token](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/token1.png) This will generate a value for the new access token. 6. (Optional) To view the value of the generated token, click the view icon in the Value field. 7. Click the Close button to save the new access token and close the dialog. ![Generated access token](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/gentoken.png) The new access token is added to the Access Tokens list and can now be selected when configuring an external node command. Procedure: Configure a command to start an external node The procedure explains how to configure a docker command for a machine you want to use as an external node. For convenience, such an external agent manager is referred to as external node. 1. Click the avatar in the upper right corner of the screen and select Admin panel. 2. From the Admin panel, go to External nodes. ![External Nodes tab](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/externalnodes.png) 3. On the External nodes tab, click the Configure command. This will open the External node start command dialog. ![External node start command dialog](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/script.png) 4. In the Name field, provide a name for the node. 5. In the Tags field, provide tags. Multiple tags are separated by commas. > **Note:** > If an agent has a set of tags, it can only be started by an external node that has all of those tags. If you do not want to define any specific tags for an external node, use the `default` tag. 6. Under Access tokens, do one of the following: * Use one of the tokens you created earlier Expand the list and select one of the available tokens. ![Selecting access token](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/select_token.png) * Generate a token Click the plus icon and perform [this procedure](#create-an-access-token). Then, select it as shown above. 7. Under CPU, cores, expand the list and select the number of available CPU cores on this machine. This parameter is used to choose which and how many agents will run on this machine. It is not required to be equal to the actual number of CPU cores. 8. Under Memory, GB, specify the amount of available RAM (in gigabytes). Similarly to the CPU, cores parameter, it correlates with the `requests` property defined in your agent configuration. 9. Under GPU, expand the list and select the number of available GPUs. This value cannot be greater than the number of actual GPUs on the machine. 10. Provide the hostname or IP address of your Datalore server and the valid external manager port in the respective fields. 11. To ensure connecting to Datalore's latest version, enable the auto-update feature by selecting the Auto-update on connect checkbox. 12. To enable log transferring, select the Enable log transferring checkbox. 13. In the Docker command box, review the script generated based on the provided values. 14. Click the Copy to clipboard button in the Docker command box to copy the command. You can now use it to run the docker container that you want to use as your new external agent manager. ![Script with provided details](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/readyscript.png) Results Once started and connected, the new external node is added to the External nodes list and can now be used for running available agents. Such machines can be selected from the editor's main menu (`Run | Change machine`). ## Manage external nodes and access tokens The instructions below explain how to view your external nodes and manage access tokens. Procedure: View external nodes As an admin, you can track the use of your external nodes from the Admin panel. 1. Click the avatar in the upper right corner of the screen and select Admin panel. 2. From the Admin panel, go to External nodes. You will see the list of all connected external nodes. ![Connected external nodes](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/external_node.png) Procedure: Manage access tokens As an admin, you can manage access tokens using the Admin panel. 1. Click the avatar in the upper right corner of the screen and select Admin panel. 2. From the Admin panel, go to External nodes. 3. Switch to the Access tokens tab. ![Access tokens tab](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/tokens_tab.png) 4. To view an access token, click the ellipsis for the respective list item and select View from the menu. In the view dialog, you can view the token value or copy the fingerprint. ![Token view](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/token_view.png) 5. To revoke an access token, click the ellipsis for the respective list item and select Revoke from the menu. Then, click the Revoke button in the confirmation dialog. > **Note:** > This action will disconnect all external nodes that are using this access token.