DICloak Agent Docker Image for server-side browser automation

Run DICloak Agent in Docker for headless and server-side workflows. Expose the Agent API on port 52100, forward CDP ports 45000-45099, persist runtime data under /dicloak/data, and connect Playwright or Puppeteer through the returned webSocketDebuggerUrl.

4 Steps to Start a DICloak Agent Container

1

Pull the Agent Image

Pull dicloakinc/dicloak-agent-image:latest from Docker Hub. Browser kernels are downloaded on demand, so the first profile startup may take longer.

2

Start with Docker Compose

Use Docker Compose with TOKEN or USER_EMAIL and USER_PASSWD, AGENT_PORT=52100, DOCKER=1, and a persistent /dicloak/data volume.

3

Verify the Agent API

Check http://127.0.0.1:52100/agent/status and /agent/user-info to confirm readiness, login state, running profile count, and kernel download progress.

4

Open a Profile and Connect

Open a browser profile through your DICloak Local API workflow, read debug_port, request /json/version, and connect Playwright or Puppeteer with webSocketDebuggerUrl.

Why Deploy DICloak Agent with Docker?

Docker gives server-side automation a repeatable runtime, persistent logged-in sessions, and predictable network boundaries.

Traditional Pain Points

  • Desktop installs are difficult to reproduce across CI, cloud servers, and long-running automation hosts.

  • Browser automation needs logged-in sessions and profile data that survive restarts without manual repair.

  • CDP ports and local API access can become risky when exposed without clear host bindings.

  • Running the wrong account type can interfere with active team sessions and make credential rotation messy.

Docker Agent Solution

  • Repeatable Agent Runtime

    Deploy the same dicloak-agent-image across development, staging, and production with Compose-managed settings.

  • Persistent Profile Data

    Keep kernels, user-data, extensions, logs, and cache in a mounted /dicloak/data directory so sessions can be reused safely.

  • Explicit Port Boundaries

    Publish the Agent API on 52100 and keep the CDP range bound to localhost by default unless your network design requires otherwise.

  • Cleaner Account Operations

    Run Docker with a dedicated internal member account so permissions, ownership, and credential rotation stay easy to manage.

Core Agent Capabilities in Docker

A production-oriented DICloak Agent runtime for persistent logged-in browser sessions, profile isolation, and CDP automation.

Agent API on Port 52100

The container exposes the HTTP Agent API on 52100 for status checks, account session inspection, and coordination with your Local API automation flow.

Forwarded CDP Port Range

Browser debugging ports are forwarded through 45000-45099. Query /json/version on the returned debug_port before connecting your automation framework.

Persistent Runtime Data

Mount /dicloak/data to keep downloaded browser kernels, profile user-data directories, extensions, logs, and runtime cache across container restarts.

Secure Account Deployment

Use a dedicated member account with the required Local API or Docker permission. Avoid exposing port 52100 publicly without firewall, VPN, or reverse-proxy protection.

Up to 100 Browser Sessions

The mapped CDP range supports up to 100 concurrent browser instances, with each active profile assigned its own debug port.

Docker Compose Lifecycle

Use the Compose template for image updates, restart policy, resource limits, shared memory, host proxy reuse, and stable operational settings.

Recommended Docker Compose Deployment

The current Agent image expects Compose-managed login variables, Agent API port 52100, CDP forwarding, and persistent /dicloak/data storage.

docker-compose.ymlYAML
services:
dicloak-agent:
image: ${DICLOAK_AGENT_IMAGE:-dicloakinc/dicloak-agent-image:latest}
restart: unless-stopped
init: true
environment:
TOKEN: ${DICLOAK_TOKEN:-}
USER_EMAIL: ${DICLOAK_USER_EMAIL:-}
USER_PASSWD: ${DICLOAK_USER_PASSWD:-}
AGENT_PORT: ${DICLOAK_AGENT_PORT:-52100}
DOCKER: 1
BACKEND_URL: ${DICLOAK_BACKEND_URL:-https://gin-server.dicloak.com/gin}
AUTH_MODE: ${DICLOAK_AUTH_MODE:-remote}
CACHE_BASE_DIR: /dicloak/data
ports:
- '${DICLOAK_AGENT_PORT:-52100}:52100'
- '127.0.0.1:45000-45099:45000-45099'
volumes:
- ${DICLOAK_DATA_DIR:-./data}:/dicloak/data
- /etc/localtime:/etc/localtime:ro
shm_size: 1gb

Login Variables

Choose TOKEN or USER_EMAIL plus USER_PASSWD. If both token and email login are present, Agent prefers email and password login.

Persistent /dicloak/data

Use a host bind mount for downloaded kernels, profile user-data, extensions, logs, and cache. Use separate host data directories for multiple instances.

Safe Port Mapping

Map 52100 for the Agent API and bind 45000-45099 to 127.0.0.1 by default. Protect 52100 if it is reachable from a public network.

One-Command Lifecycle

Run docker compose up -d to start, docker compose pull to update, and docker compose logs -f dicloak-agent to inspect runtime behavior.

What Are Teams Building with DICloak Agent Docker?

The Agent image is designed for server-side automation that needs stable browser identity, persistent sessions, and CDP connectivity.

AI Agent Browser Sessions

Give AI agents persistent logged-in browser sessions that can be reopened and controlled through CDP in server-side workflows.

Browser Automation Services

Run Playwright or Puppeteer against DICloak profiles on servers while keeping fingerprints, storage, and profile identity isolated.

CI and Scheduled Jobs

Use repeatable containers for scheduled browser tasks, regression checks, or service-side workflows that need stable profile state.

Multi-Account Operations

Operate separate browser environments for multiple accounts while preserving user-data directories and reducing cross-session interference.

Ad and Content Verification

Open profiles through your Local API flow and inspect regional pages, ad placements, and authenticated experiences from controlled browser sessions.

E-Commerce Monitoring

Monitor regional pricing, inventory, promotions, and account-specific pages using persistent browser profiles and controlled CDP connections.

Integrate with Automation and Agent Toolchains

DICloak Agent Docker works with CDP-compatible frameworks and server-side automation stacks after your Local API flow opens a browser profile.

Playwright
Puppeteer
Selenium
OpenAI Agents
Claude MCP
Gemini
Docker Compose
Kubernetes
GitHub Actions
AWS ECS
Get Started with DICloak Agent Docker

Docker Hub: dicloakinc/dicloak-agent-image