%20alt.svg){kind=small}
Download EventStoreDB
EventStoreDB Server
1. Install EventStoreDB on Windows
1a) Download the binaries
Download the binaries for EventStoreDB using this link:
EventStore-OSS-Windows-2019-v22.10.1.zip
Unzip the downloaded archive to the desired folder location.
1b) Install from Chocolatey
Or install the latest package from Chocolatey using the following command in an elevated terminal:
choco install eventstore-oss2. Start EventStoreDB in dev mode
Run the following command to start EventStoreDB in dev mode with default configuration:
EventStore.ClusterNode.exe --devClick “Yes” if you are asked to install a certificate.
3. Login to the database Admin UI
Once the database has started, go to https://localhost:2113.
If your browser detects a security issue with the certificate, ask the browser to ignore the error and continue.
Login to the Admin UI using the default credentials:
Username: admin
Password: changeit
1. Install EventStoreDB on Linux
1a) Download the binaries
Download the binaries for EventStoreDB using this link:
EventStore-OSS-Linux-v22.10.1.tar.gz
Extract the archive to the desired folder location.
1b) Install from PackageCloud
EventStoreDB has pre-built packages available for Debian-based distributions and manual instructions for distributions that use RPM.
The package name to install is eventstore-oss.
2. Start EventStoreDB in dev mode
Run the following command to start EventStoreDB in dev mode with default configuration (by default installed in /usr/bin/):
eventstored --dev3. Login to the database Admin UI
Once the database has started, go to https://localhost:2113.
If your browser detects a security issue with the certificate, ask the browser to ignore the error and continue.
Login to the Admin UI using the default credentials:
Username: admin
Password: changeit
1. Install EventStoreDB on Ubuntu 18.04
1a) Download the binaries
Download the binaries for EventStoreDB using this link:
EventStore-OSS-Linux-v22.10.1.ubuntu-18.04.deb
Install the package using the following command:
dpkg -i /path/to/EventStore-OSS-Linux-v22.10.1.ubuntu-18.04.deb1b) Install from PackageCloud
EventStoreDB has pre-built packages available for Ubuntu. The package name to install is eventstore-oss.
Or install using the following commands:
curl -s https://packagecloud.io/install/repositories/EventStore/EventStore-OSS/script.deb.sh | sudo bash
sudo apt-get install eventstore-oss=22.10.12. Start EventStoreDB in dev mode
Run the following command to start EventStoreDB in dev mode with default configuration (by default installed in /usr/bin/):
eventstored --dev3. Login to the database Admin UI
Once the database has started, go to https://localhost:2113.
If your browser detects a security issue with the certificate, ask the browser to ignore the error and continue.
Login to the Admin UI using the default credentials:
Username: admin
Password: changeit
1. Install EventStoreDB on Ubuntu 20.04
1a) Download the binaries
Download the binaries for EventStoreDB using this link:
EventStore-OSS-Linux-v22.10.1.ubuntu-20.04.deb
Install the package using the following command:
dpkg -i /path/to/EventStore-OSS-Linux-v22.10.1.ubuntu-20.04.deb1b) Install from PackageCloud
EventStoreDB has pre-built packages available for Ubuntu. The package name to install is eventstore-oss.
Or install using the following commands:
curl -s https://packagecloud.io/install/repositories/EventStore/EventStore-OSS/script.deb.sh | sudo bash
sudo apt-get install eventstore-oss=22.10.12. Start EventStoreDB in dev mode
Run the following command to start EventStoreDB in dev mode with default configuration (by default installed in /usr/bin/):
eventstored --dev3. Login to the database Admin UI
Once the database has started, go to https://localhost:2113.
If your browser detects a security issue with the certificate, ask the browser to ignore the error and continue.
Login to the Admin UI using the default credentials:
Username: admin
Password: changeit
1. Install EventStoreDB on Ubuntu 22.04
This release for Ubuntu 22.04 (Jammy Jellyfish) is currently in Preview.
1a) Download the binaries
Download the binaries for EventStoreDB using this link:
EventStore-OSS-Linux-v22.10.1-preview1.ubuntu-22.04.deb
Install the package using the following command:
dpkg -i /path/to/EventStore-OSS-Linux-v22.10.1-preview1.ubuntu-22.04.deb1b) Install from PackageCloud
EventStoreDB has pre-built packages available for Ubuntu. The package name to install is eventstore-oss.
Or install using the following commands:
curl -s https://packagecloud.io/install/repositories/EventStore/EventStore-OSS/script.deb.sh | sudo bash
sudo apt-get install eventstore-oss=22.10.1~preview12. Start EventStoreDB in dev mode
Run the following command to start EventStoreDB in dev mode with default configuration (by default installed in /usr/bin/):
eventstored --dev3. Login to the database Admin UI
Once the database has started, go to https://localhost:2113.
If your browser detects a security issue with the certificate, ask the browser to ignore the error and continue.
Login to the Admin UI using the default credentials:
Username: admin
Password: changeit
1. Run EventStoreDB on Mac OS (Intel)
To run EventStoreDB on Mac OS you need to use Docker.
2. Run EventStoreDB in a Docker container
You can easily run EventStoreDB in a Docker container as a single node, using insecure mode. It's good enough in most cases to try out the product and for local development purposes.
Run the following command to start EventStoreDB in dev mode with default configuration and without security:
docker run --name esdb-node -it -p 2113:2113 -p 1113:1113 \
eventstore/eventstore:latest --insecure --run-projections=All --enable-atom-pub-over-http3. Access the database Admin UI
Once the database has started, go to https://localhost:2113. With security disabled you won't be required to login.
1. Run EventStoreDB on Mac OS (M1/M2)
To run EventStoreDB on Mac OS you need to use Docker. You will need to use the dedicated ARM64 release.
2. Run EventStoreDB in a Docker container
You can easily run EventStoreDB in a Docker container as a single node, using insecure mode. It's good enough in most cases to try out the product and for local development purposes.
Run the following command to start EventStoreDB in dev mode with default configuration and without security:
docker run --name esdb-node -it -p 2113:2113 -p 1113:1113 \
eventstore/eventstore:22.10.1-alpha-arm64v8 --insecure --run-projections=All --enable-atom-pub-over-http3. Access the database Admin UI
Once the database has started, go to https://localhost:2113. With security disabled you won't be required to login.
1. Run EventStoreDB in a Docker container
You can easily run EventStoreDB in a Docker container as a single node, using insecure mode. It's good enough in most cases to try out the product and for local development purposes.
Run the following command to start EventStoreDB in dev mode with default configuration and without security:
docker run --name esdb-node -it -p 2113:2113 -p 1113:1113 \
eventstore/eventstore:latest --insecure --run-projections=All --enable-atom-pub-over-http2. Access the database Admin UI
Once the database has started, go to https://localhost:2113. With security disabled you won't be required to login.
1. EventStoreDB OSS Github repository
The official open-source repository for EventStoreDB is eventstore/eventstore and can be found here: https://github.com/EventStore/EventStore
Building from source and contributing
In the readme file you will find instructions for building from source and contributing to the open-source project.
EventStoreDB Client
1. Download and install the client SDK
1a) Download from source
The Github repository is here: https://github.com/EventStore/EventStore-Client-dotnet
1b) Install from NuGet
The NuGet package is EventStore.Client.Grpc.Streams found here: https://www.nuget.org/packages/EventStore.Client.Grpc.Streams
2. Connect to the database and write and read your first event
Follow our getting started guide for C# on our Developers' website: https://developers.eventstore.com/clients/grpc/
1. Download and install the client SDK
1a) Download from source
The Github repository is here: https://github.com/EventStore/EventStoreDB-Client-Java
1b) Install from Maven
The Maven package is com.eventstore/db-client-java found here: https://search.maven.org/artifact/com.eventstore/db-client-java
2. Connect to the database and write and read your first event
Follow our getting started guide for Java on our Developers' website: https://developers.eventstore.com/clients/grpc/
1. Download and install the client SDK
1a) Download from source
The Github repository is here: https://github.com/EventStore/EventStore-Client-NodeJS
1b) Install from Yarn or NPM
The Node package is @eventstore/db-client.
Yarn: https://yarnpkg.com/package/@eventstore/db-client
NPM: https://www.npmjs.com/package/@eventstore/db-client
2. Connect to the database and write and read your first event
Follow our getting started guide for JavaScript or TypeScript on our Developers' website: https://developers.eventstore.com/clients/grpc/
1. Download and install the client SDK
The Github repository is here: https://github.com/EventStore/EventStore-Client-Go
2. Connect to the database and write and read your first event
Follow our getting started guide for Go on our Developers' website: https://developers.eventstore.com/clients/grpc/
1. Download and install the client SDK
The Github repository is here: https://github.com/EventStore/EventStoreDB-Client-Rust
2. Connect to the database and write and read your first event
Follow our getting started guide for Rust on our Developers' website: https://developers.eventstore.com/clients/grpc/
1. Download and install the client SDK
The Haskell client for EventStoreDB uses the TCP protocol which is legacy and no longer supported. Please consider using one of our gRPC clients instead.
1a) Download from source
The Github repository is here: https://github.com/EventStore/EventStoreDB-Client-haskell
1b) Install from Hackage
The Hackage package is eventstore found here: https://hackage.haskell.org/package/eventstore
2. Connect to the database and write and read your first event
Follow the usage instructions here: https://github.com/EventStore/EventStoreDB-Client-haskell#how-to-use
What next?
Other key features
Advanced configuration
Select the EventStoreDB Server or Client you would like to download
Follow the instructions to download, install, and get started
Visit our Discuss forum for additional help from us and the community