Skip to content

Migration

Kurrent Surge replaces the earlier .NET clients for KurrentDB. Pick the guide that matches what you have today.

Both migrations are the same shape, because the v1 KurrentDB client was a rebrand of the EventStoreDB one. The differences are in the package names you remove and the namespaces you replace.

This is the one thing you do not have to change. Kurrent Surge accepts every scheme the older clients used:

Scheme Meaning
kurrentdb:// Single node
kurrentdb+discover:// Cluster, with gossip discovery
esdb:// Legacy alias for kurrentdb://
esdb+discover:// Legacy alias for kurrentdb+discover://
eventstore:// Legacy alias for kurrentdb://
eventstore+discover:// Legacy alias for kurrentdb+discover://

Connection strings held in environment variables, config files, or a secrets manager do not need to change before you migrate. Every parameter behaves identically across all six schemes, including tls, tlsVerifyCert, keepAliveInterval, and nodePreference.

Durations in a connection string are read in the same units every KurrentDB SDK uses. See Breaking Changes for the behaviour that moved.

The package layout, the namespaces, and the API shape. In return you get one package instead of four, one client instead of one per feature, and typed exceptions instead of a single catch-all.