EventStoreDB is available on multiple platforms. Below you can find instructions for installing an EventStoreDB instance.
Refer to the clustering documentation to upgrade your deployment to a highly available cluster. Cluster consists of several EventStoreDB nodes, follow the guidelines from this section to install each node of the cluster.
After installing an EventStoreDB instance you'd need to set up its networking so you can connect to it from other machines.
Follow the security guidelines to prepare your instance of cluster for production use.
Check the configuration page to find out how to configure your deployment.
Install from PackageCloud
EventStoreDB has pre-built packages available for Debian-based distributions, manual instructions for distributions that use RPM, or you can build from source. The final package name to install is
If you installed from a pre-built package, the server gets registered as a service. Therefore, you can start EventStoreDB with:
sudo systemctl start eventstore
When you install the EventStoreDB package, the service doesn't start by default. It's done to allow you to change the configuration, located at /etc/eventstore/eventstore.conf and to prevent creating database and index files in the default location.
We recommend that when using Linux you set the 'open file limit' to a high number. The precise value depends on your use case, but at least between
Building from source
You can also build EventStoreDB on Linux from source. Before doing that, you need to install Mono. We recommend Mono 5.16.0, but other versions may also work. EventStoreDB packages have Mono embedded, so you don't need to install anything except the EventStoreDB package.
If you installed one of the pre-built packages for Debian based systems, you can remove it with:
sudo apt-get purge eventstore-oss
This removes EventStoreDB completely, including any user settings.
If you built EventStoreDB from source, remove it by deleting the directory containing the source and build, and manually removing any environment variables.
The prerequisites for installing on Windows are:
- NET Framework 4.0+
Install from Chocolatey
EventStoreDB has Chocolatey packages available that you can install with the following command in an elevated terminal:
choco install eventstore-oss
Download the binaries
You can also download a binary, unzip the archive and run from the folder location with an administrator console.
The following command starts EventStoreDB with the database stored at the path ./db and the logs in ./logs. Read mode about configuring the EventStoreDB server node in the Configuration section.
EventStore.ClusterNode.exe --db ./db --log ./logs
EventStoreDB runs in an administration context because it starts an HTTP server through
http.sys. For permanent or production instances you need to provide an ACL such as:
netsh http add urlacl url=http://+:2113/ user=DOMAIN\username
For more information, refer to Microsoft
add urlacl documentation.
To build EventStoreDB from source, refer to the EventStoreDB GitHub repository.
If you installed EventStoreDB with Chocolatey, you can uninstall with:
choco uninstall eventstore-oss
This removes the
eventstore-oss Chocolatey package.
If you installed EventStoreDB by downloading a binary, you can remove it by:
- Deleting the
- Removing the directory from your PATH.
Run with Docker
EventStoreDB has a Docker image available for any platform that supports Docker.
Pull the Docker image:
docker pull eventstore/eventstore:release-5.0.11
Run the container:
docker run --name eventstore-node -it -p 2113:2113 -p 1113:1113 eventstore/eventstore:release-5.0.11
Refer to the image overview for more information.
The container won't accept command line parameters to the server executable. We recommend configuring EventStoreDB using the configuration file and mapping it as a volume.
In order to sustainably keep the data, we also recommend mapping the database and index volumes.
Use Docker Compose
EventStoreDB has a Docker image available for any platform that supports Docker. In order to save keystrokes it is possible to run EventStoreDB via Docker Compose.
docker-compose.yaml with following content:
version: '3.4' services: eventstore.db: image: eventstore/eventstore:release-v5 environment: - EVENTSTORE_CLUSTER_SIZE=1 - EVENTSTORE_RUN_PROJECTIONS=All - EVENTSTORE_START_STANDARD_PROJECTIONS=True - EVENTSTORE_DB=/var/lib/eventstore-data - EVENTSTORE_INDEX=/var/lib/eventstore-index - EVENTSTORE_LOG=/var/log/eventstore - EVENTSTORE_EXT_TCP_PORT=1113 - EVENTSTORE_EXT_HTTP_PORT=2113 ports: - "1113:1113" - "2113:2113" volumes: - type: volume source: eventstore-volume-data target: /var/lib/eventstore-data - type: volume source: eventstore-volume-index target: /var/lib/eventstore-index - type: volume source: eventstore-volume-logs target: /var/log/eventstore volumes: eventstore-volume-data: eventstore-volume-index: eventstore-volume-logs:
Run the instance:
The Compose file above runs EventStoreDB as a single instance.