Skip to content
Doppelganger logo

Running Doppelganger on ARM Devices

Doppelganger now officially supports ARM architectures! This means you can run the full browser automation stack natively on Apple Silicon (M1/M2/M3) Macs and valid ARM64 Linux environments (like Raspberry Pi 4/5) without emulation performance hits.

Prerequisites#

  • Docker Desktop (Mac) or Docker Engine (Linux)
  • Git

Quick Start (Docker Compose)#

The easiest way to get up and running is with Docker Compose. We have updated our configuration to automatically detect your system architecture and pull the correct images.

1. Clone the Repository#

You need the docker-compose.yml file from the repository.

git clone https://github.com/mnemosynestack/doppelganger.git
cd doppelganger

2. Start the Service#

Run the following command to build and start the containers. This will pull the ARM64-compatible layers for Node.js and Playwright.

docker compose up --build -d

3. Access the Dashboard#

Once the containers are running:

Troubleshooting#

  • Ports: Ensure ports 11345 and 54311 are not in use by other services.
  • Emulation: If you previously forced platform: linux/amd64 in any custom scripts, remove those flags to let Docker use the native ARM64 images for better performance.
Previous
Next