Skip to main content

App-to-Node communication errors

Apps communicating with Actyx on Docker​

By default, the SDK tries to connect to Actyx on localhost. If your Actyx and app container are not both using the host's networking directly via --network=host (only available on Linux), you therefore need to manually specify the host and the port to let the SDK know where to reach Actyx.

In the docker run command​

When running your app container, you need to add the following flag:

-e AX_STORE_URI="<IP address of the Actyx container>:4454/api/v2

Running macOS or Windows?

On macOS or windows, you can just use host.docker.internal instead of the IP address of your Actyx container.

In a Docker Compose file​

This is an exemplary docker-compose file:

version: "3.9"
services:
  actyx:
    image: actyx/actyx:2.0.1
    privileged: true
    ports:
      - "4001:4001"
      - "4454:4454"
      - "4458:4458"
    volumes:
      - actyx_data:/data
  app:
    image: example-app
    restart: always
    environment: 
        - AX_STORE_URI=actyx:4454/api/v2
    depends_on: 
        - actyx
volumes:
  actyx_data: {}

Did not find what you were looking for?​

If you couldn't a solution to your problem, please don't hesitate to contact us in our community forum or on our Discord server. We'll do our best to get back to you with answers as fast as possible.