riccardone/linker repository overview

Linker – Cross-cluster replication for KurrentDb⁠ (formerly EventStore).

Replicates events from an origin KurrentDb instance to a destination, preserving ordering and handling conflicts. Supports active-passive, active-active, fan-out and fan-in topologies.

⁠Quick start

docker run --rm \
  -v $(pwd)/config:/config \
  -v $(pwd)/certs:/certs \
  -v $(pwd)/data:/data \
  -e LINKER_CONFIG_PATH=/config/appsettings.json \
  riccardone/linker:latest

⁠Mount points

⁠Minimal configuration

Create /config/appsettings.json:

{
  "DataFolder": "/data",
  "links": [
    {
      "origin": {
        "connectionString": "esdb://admin:changeit@db01:2113?tls=false",
        "connectionName": "db01"
      },
      "destination": {
        "connectionString": "esdb://admin:changeit@db02:2113?tls=false",
        "connectionName": "db02"
      },
      "filters": []
    }
  ]
}

For TLS connections add certificateFile and privateKeyFile pointing to PEM files in /certs.

⁠Key settings

⁠Topologies

• Active-Passive – single link, one-way replication
• Active-Active – two mirrored links (loop prevention via $origin metadata)
• Fan-Out – same origin, multiple destinations
• Fan-In – multiple origins, same destination

⁠Links

• GitHub: https://github.com/riccardone/Linker⁠
• NuGet (programmatic use): Linker.Core