Frequently asked questions (FAQs)
Kurrent
-
What is Kurrent?
Kurrent is a new category of operational database that has evolved from the Event Sourcing community. Powered by an event-native data model, events are stored all the way down with the context of why they have happened. Providing flexible, real-time data insights in the language your business understands.
Download the newest version here . -
How do I get started with Kurrent?
-
Where can I find the licensing information?
Click here to view Event Store Ltd’s licensing information.
-
Where can I find documentation?
For guidance on installation, development, deployment, and administration, see the User Documentation.
-
What is the latest version of Kurrent?
You can find the latest versions of Kurrent on our downloads page.
-
What clients are available for Kurrent?
This getting started guide shows you how to get started with Kurrent by setting up an instance or cluster and configuring it. Kurrent supports two protocols: gRPC and TCP(legacy).
EventStoreDB supported clients
- Go: EventStore/EventStore-Client-Go
- .NET: EventStore/EventStore-Client-Dotnet
- Java: (EventStore/EventStoreDB-Client-Java
- Node.js (javascript/typescript): EventStore/EventStore-Client-NodeJS
- Rust: EventStore/EventStoreDB-Client-Rust
- Read more in the gRPC clients documentation
Legacy TCP Clients
- .Net: EventStoreDB-Client-Dotnet-Legacy
- JVM: EventStore.JVM
- Haskell: EventStoreDB-Client-Haskell
Community developed clients
- Elixir: NFIBrokerage/spear
- Python: pyeventsourcing/esdbclient
- Ruby: yousty/event_store_client
Read more in the documentation.
-
How do I get started with Kurrent Cloud?
Follow our guide to get started with Kurrent Cloud.
-
How do I self-manage Kurrent?
Follow these steps to host Kurrent yourself.
-
Where can I find the Kurrent Community?
Our community is a space to learn more about Kurrent, the operational database that values data at its origin. Come discover why we are so much more than just another Kurrent.
-
How do I contribute?
Development is done on the
master
branch. We attempt to do our best to ensure that the history remains clean and to do so, we generally ask contributors to squash their commits into a set or single logical commit.If you want to switch to a particular release, you can check out the release branch for that particular release. For example:
git checkout release/oss-v22.10
-
How do I build Kurrent from source?
EventStoreDB is written in a mixture of C# and JavaScript. It can run on Windows, Linux and macOS (using Docker) using the .NET Core runtime.
Prerequisites
Once you've installed the prerequisites for your system, you can launch a
Release
build of EventStore as follows:dotnet build -c Release src
The build scripts:
build.sh
andbuild.ps1
are also available for Linux and Windows respectively to simplify the build process.To start a single node, you can then run:
dotnet ./src/EventStore.ClusterNode/bin/x64/Release/net6.0/EventStore.ClusterNode.dll --dev --db ./tmp/data --index ./tmp/index --log ./tmp/log
Running the tests
You can launch the tests as follows:
dotnet test src/EventStore.sln
Build Kurrent Docker image
You can also build a Docker image by running the command:
docker build --tag myeventstore . \
--build-arg CONTAINER_RUNTIME={container-runtime}
--build-arg RUNTIME={runtime}For instance:
docker build --tag myeventstore . \
--build-arg CONTAINER_RUNTIME=bullseye-slim \
--build-arg RUNTIME=linux-x64Note: Because of the Docker issue, if you're building a Docker image on Windows, you may need to set the
DOCKER_BUILDKIT=0
environment variable. For instance, running in PowerShell:$env:DOCKER_BUILDKIT=0; docker build --tag myeventstore . `
--build-arg CONTAINER_RUNTIME=bullseye-slim `
--build-arg RUNTIME=linux-x64Currently we support following configurations:
- Bullseye slim:
CONTAINER_RUNTIME=bullseye-slim
RUNTIME=linux-x64
- Focal:
CONTAINER_RUNTIME=focal
RUNTIME=linux-x64
- Alpine:
CONTAINER_RUNTIME=alpine
RUNTIME=alpine-x64
You can verify the built image by running:
docker run --rm myeventstore --insecure --what-if
-
Does Event Store offer commercial support for Kurrent?
We offer plans for every stage of project from proof of concept to successful operation in production, with a range of SLAs to suit startups to enterprise organizations worldwide. You can view more here.
-
Does Kurrent offer training?
We offer public and private training for Event Sourcing, CQRS, DDD, and Kurrent with our professional training courses for developers and software architects. You can view more information here.
-
Need help?
Kurrent Cloud
-
What is Kurrent Cloud?
Kurrent Cloud is a fully managed cloud offering that’s designed to make it easy for developers to build and run highly available and secure applications that incorporate EventStoreDB without having to worry about managing the underlying infrastructure.
You can provision EventStoreDB clusters in AWS, Azure, and GCP, and connect these services securely to your own cloud resources.
-
How do I get started with Kurrent Cloud?
Follow our guide to get started with Kurrent Cloud.
-
Where can I find Kurrent Cloud documentation?
You can find our Kurrent Cloud documentation here.
-
Can I set up more than one organization per account?
Yes, you can have as many organizations as you need. Please note that each organization will be billed separately.
-
How do I provision Kurrent clusters?
See our Getting Started guide here.
-
Will my Kurrent Cloud organization be fully self-contained in the underlying cloud provider?
Every organization has its own individual AWS account, GCP project and Azure subscription.
-
How can I determine the ideal instance size for my project?
Please use this guide. If you have any questions, please contact us through the Support button in the Kurrent Cloud Console.
-
How do I migrate my database to Kurrent Cloud?
Please follow this guide to migrate your data.
-
How do I connect Kurrent Cloud to my application running in a cloud Kubernetes cluster?
Please follow our guide here.
-
Is it possible to change the cluster instance size without downtime?
Yes, a cluster’s instance size can be increased by following these steps. On a three-node cluster this will be a rolling upgrade which ensures zero downtime.
-
Is it possible to change a cluster’s topology (e.g. upgrade from a single-node instance to a three-node cluster)?
No, we don't have this feature available yet. However, you can always do it using backup and restore.
-
Does Kurrent cloud support automatic cluster node resizing?
Automatic resizing of cluster nodes is currently on the Kurrent Cloud roadmap.
-
Does Kurrent Cloud support automatic disk resizing?
No, automatic disk resizing is currently not available. Disks can be expanded manually using the procedure in the documentation.
If you wish to automate cluster resizing, the esc command line tool, as well as the Terraform and Pulumi providers are options to consider.
Because cloud providers limit how often disk resize operations can be performed the Kurrent Cloud may enforce a waiting period on recently resized clusters before they can get resized again.
-
Does Kurrent Cloud have alerting functionality for cluster issues?
Yes. We currently integrate with OpsGenie and Slack. Learn more in the Events Console documentation section.
-
How do you handle infrastructure related issues, which cause unavailability or degradation of service?
How do you handle infrastructure related issues, which cause unavailability or degradation of service?
-
Can I request a region to be added to Kurrent Cloud?
You can see the list of supported regions when you create a new cluster in the Cloud Console.
If you think a region should be available please contact us.
-
Does the admin UI run on the provisioned cluster?
Yes. Go to the clusters list in the Cloud Console, select the cluster you need and click on the
Addresses
tab on the bottom panel. You will find the admin UI URL there. You need to be connected to a network, which is routed to Event Store Cloud to open the admin UI in your browser. -
Are there plans for the scheduled scavenge feature?
Yes, scheduled scavenge will be released in EventStoreDB version 24.10, which will be available on Event Store Cloud.
-
Can I automate backups?
Yes, backups can be scheduled to run automatically. Please see the documentation here.
-
How can I download a backup of my data?
To obtain a copy of your data, please contact support using the button in the Cloud Console UI.
The ability to download backups directly from the UI is on our roadmap.
-
What is the SLA for EKurrent Cloud?
You can find out about the SLA levels provided by Kurrent Cloud in our Service Level Agreement.
-
Does Kurrent offer commercial support?
Yes,. Please click here to find out more.
-
Does Kurrent have a security policy?
Event Store Ltd has security policies in place. You can find out more here.
If you have specific questions please contact us.
-
Has the system been independently audited?
Event Store Ltd is aware of the security importance. We're treating it is as a high priority. Our Cloud offering has been independently audited, and we achieved SOC 2 and ISO 27001 certification in January 2022.
If you have specific questions please contact us.
-
How much does Kurrent Cloud cost?
You can view our pricing here.
-
Need help?