For the complete documentation index, see llms.txt. This page is also available as Markdown.

Local Agents

A local agent lets Euno reach databases that run inside your private network β€” without opening inbound firewall ports. The agent connects outbound to Euno's relay, and Euno routes source integration traffic through the agent's encrypted tunnel to your database.

Local agents are currently supported for MySQL and SQL Server integrations.

Step 1: Create a local agent in Euno

  1. Navigate to Account Settings β†’ Local Agents.

  2. Click + Create agent.

  3. Enter a name for the agent (e.g. my-private-network-agent) and optionally a description (e.g. Production network - US East).

  4. Save. On the confirmation screen, copy the Agent ID and Agent Secret.

Step 2: Deploy the agent container

Quick test

docker run -d --restart unless-stopped \
  -e AGENT_ID=<your-agent-id> \
  -e AGENT_SECRET=<your-agent-secret> \
  eunoai/euno-local-agent:latest

Create a docker-compose.yml file on the machine that has access to your private network:

Then start the agent:

Environment variables

Variable
Required
Description

AGENT_ID

Yes

Agent UUID from the Euno Local Agents UI

AGENT_SECRET

Yes

Secret from agent creation (shown once)

Step 3: Verify the connection

  1. Go back to Account Settings β†’ Local Agents and click Refresh.

  2. The agent's status should change from Disconnected to Connected.

You can also verify by checking the container logs:

Step 4: Configure a source to use the agent

When creating or editing a source (currently supported for MySQL and SQL Server), expand the Advanced section and select your agent from the Local agent dropdown. Set the hostname to your database server address as reachable from within your private network.

Click Test & Save. Euno will validate the connection through the agent before saving.

Managing agents

Action
How

Rename

Click β‹― next to the agent β†’ Edit. Change the name in the form. This does not affect the connection.

Stop

Stop the agent container. The UI will show Disconnected after a refresh.

Delete

Click β‹― next to the agent β†’ Delete. Update any sources that used the agent before deleting.

Troubleshooting

Symptom
Fix

Status stays Disconnected after starting the container

Check that AGENT_ID and AGENT_SECRET are correct. Inspect container logs for connection errors.

Source run fails with "agent not connected"

Ensure the agent container is running. Restart it if needed, then refresh the Local Agents page to confirm the status is Connected before re-running.

Source run fails with "agent not found"

The agent was deleted from Euno. Create a new agent and update the source's Advanced settings to select it.

Source run fails with "Failed to connect to [database]"

Verify that the database hostname is reachable from the machine running the agent container (not the Euno cloud). Check firewall rules and credentials.

no matching manifest for linux/arm64/v8

Add platform: linux/amd64 to your docker-compose.yml under the euno-local-agent service. This applies when running on Apple Silicon Macs for local testing.

Last updated