Skip to content
Doppelganger logo

Installation & Quick Start

This guide walks you through installing Doppelganger and running your first local automation environment in just a few minutes.

Doppelganger is distributed as a Docker image and runs entirely on your own machine or infrastructure.

Requirements#

Before you begin, ensure you have:

  • Docker installed (Docker Desktop or Docker Engine)
  • A modern desktop operating system (Linux, macOS, or Windows)
  • 4 GB of RAM recommended (lower may work, but stability is not guaranteed)

No additional dependencies are required.

Pull the Docker Image#

Download the latest Doppelganger image from Docker Hub:

    docker pull mnemosyneai/doppelganger:latest

Run Doppelganger#

From an empty directory, start Doppelganger using the following command:

    docker run -d \
      --name doppelganger \
      -p 11345:11345 \
      -p 54311:54311 \
      -v $(pwd)/data:/app/data \
      -v $(pwd)/public:/app/public \
      -v $(pwd)/storage_state.json:/app/storage_state.json \
      mnemosyneai/doppelganger:latest

This command:

  • Exposes the web interface on port 11345
  • Persists task data and state to your local filesystem
  • Runs Doppelganger in detached mode

npm Installation (Alternative to Docker)#

Doppelganger can also be installed via npm.
This uses the same core runtime and behavior as the Docker image, but is distributed as an npm package for developers who prefer Node-based workflows.

Requirements#

  • Node.js 18+
  • npm or pnpm
  • 4 GB of RAM recommended
  • Linux, macOS, or Windows

Install via npm#

From an empty directory, install Doppelganger:

npm install @doppelgangerdev/doppelganger

Run Doppelganger#

Start the local Doppelganger server:

npx doppelganger

By default, this will:

Start the Doppelganger runtime

Expose the dashboard on port 11345

Persist data locally (same behavior as Docker)

Open the Dashboard#

Once the container is running, open your browser and navigate to:

    http://localhost:11345

You should see the Doppelganger dashboard.

Verify the Installation#

To confirm everything is working:

  1. Create a new task
  2. Add a Navigate block
  3. Enter a URL (for example, https://example.com)
  4. Run the task

If the page loads successfully inside the browser view, Doppelganger is installed correctly.

Stopping and Restarting#

Docker#

To stop the container:

    docker stop doppelganger

To start it again:

    docker start doppelganger

npm#

If running via npm, stop the process with Ctrl + C

To start it again:

npx doppelganger

Updating Doppelganger#

To update to the latest version:

    docker pull mnemosyneai/doppelganger:latest
    docker stop doppelganger
    docker rm doppelganger

Then rerun the docker run command above.

npm#

npm install @doppelgangerdev/doppelganger@latest

Then restart Doppelganger:

npx doppelganger

You are now ready to begin automating with Doppelganger.

Previous
Next