Installing EventSourcingDB¶
This guide shows how to install EventSourcingDB and verify that it's working correctly. It covers Docker as well as macOS, Linux and Windows. At the end, you will have a running EventSourcingDB instance, ready for use.
Using Docker¶
Docker is the recommended way to run EventSourcingDB, as it simplifies the setup process by providing a pre-configured environment.
Downloading the Latest Version¶
To get the latest version of EventSourcingDB, run:
Downloading a Specific Version¶
To fetch a specific version, add the desired version number as a tag. For example, to download version 1.2.0:
A complete list of available versions is available on Docker Hub.
Verifying the Installation¶
After downloading, verify the installation by checking the version:
This command will display the installed version of EventSourcingDB. If the version number matches your expectation, the installation was successful.
For additional details, refer to Deploying with Docker, Deploying on Kubernetes, Managing Configuration and Secrets, and Running EventSourcingDB.
Using Pre-Built Binaries¶
If you prefer not to use Docker, you can download pre-built binaries for your operating system and CPU architecture.
Downloading the Latest Version¶
To get the latest version of EventSourcingDB, select your operating system and CPU architecture:
| Architecture | Version | Download | Size | SHA256 |
|---|---|---|---|---|
| ARM64 | 1.2.0 | Download | 42.9 MB | 15201a5215a45e8bd7edb80275c32fa16ba37ab9fe4e06be2daf95e747bcfa76 |
| x86 | 1.2.0 | Download | 43.8 MB | 33c15c1bfe4093ba2036549d332755b52fe0b06243edc6f07c76071876845b6d |
Downloading a Specific Version¶
To download a specific version of EventSourcingDB, expand the list below:
Previous Versions
| Architecture | Version | Download | Size | SHA256 |
|---|---|---|---|---|
| ARM64 | 1.1.0 | Download | 37.4 MB | 9404d314687b29a58eab1649a2db052450f28cbeab966ef2b959ba1b7d4113af |
| ARM64 | 1.0.3 | Download | 42.7 MB | ef09eb25205e4994f44e8b490d47b3d0ae5497be13b28654f1ecb6e4206a86b6 |
| ARM64 | 1.0.2 | Download | 42.6 MB | 2f9e9eb26ec8ee8bf00744eabb1a54424eae150e451d1035ba6c3b7537d40028 |
| ARM64 | 1.0.1 | Download | 42.4 MB | edef81d66fc4d005182ffe80a0767c2abe6f1da8f2cbad9cc8855dffc76a3356 |
| ARM64 | 1.0.0 | Download | 57.9 MB | d2183c07f9b24a8987f379b899d502e3d73f73abb49ba53b94e94f4e456fc26d |
| x86 | 1.1.0 | Download | 38.3 MB | 9834b26a5c7b5326347172a72f05e38411749b18a57d4d7cc2928f50031fad39 |
| x86 | 1.0.3 | Download | 43.2 MB | e79aa0a9813ced6312225391fd72d6ff87eb866e90efe610784e6e889c2c41ef |
| x86 | 1.0.2 | Download | 43.2 MB | 77c861656c214dd72684147bc6a7ea42ea359828591382d0d277afcf3c304a0d |
| x86 | 1.0.1 | Download | 43.0 MB | 3744758d7b36339bfde0d5eb22fde1bb3c8d2131a3eaaafb5a016fc25c894dfb |
| x86 | 1.0.0 | Download | 58.6 MB | 82c2e7fce8efad0fd10b6e452e50b6d3fd8bb339446e5b2c45704736458b6d49 |
| Architecture | Version | Download | Size | SHA256 |
|---|---|---|---|---|
| ARM64 | 1.1.0 | Download | 36.7 MB | d1d31a39944f83989dd3b30b8069018706489a474fc3669f2599523336b9ab15 |
| ARM64 | 1.0.3 | Download | 41.8 MB | f830d3f9188ba1d1d99871ad12ee733933931cecd89d54dcf079b1ff2163a802 |
| ARM64 | 1.0.2 | Download | 41.8 MB | e54930fc1d1d9c422f95d5378676f5489ba7770ba38327ac70ae63bdea8e3907 |
| ARM64 | 1.0.1 | Download | 41.6 MB | c9f685a0a34dd9d06adb57c6110d3eb7dcbc96674d089a243e537ee9641afe86 |
| ARM64 | 1.0.0 | Download | 57.3 MB | 3d7657b0e8840c92f5db91a5a578264d18f8519acfb5218a1abcd3e51213e9da |
| x86 | 1.1.0 | Download | 37.8 MB | 0e662724f5b1d3cd66769798a77c9dfec6e799ff86e1975bd2415caaa39d7a1e |
| x86 | 1.0.3 | Download | 42.7 MB | 9c1112bce1803e9d194cf298a9fd18b8192a266c6c10e44598f03ad08a0deefa |
| x86 | 1.0.2 | Download | 42.7 MB | 3f794345673d1db33bfae6cafa3ee0811302c46ba9d3305f315a3799a07398c3 |
| x86 | 1.0.1 | Download | 42.5 MB | 56fd02d1aabd1193eed00f3576dd51e0195cdebc0569f2c160c8b628f4b2f39a |
| x86 | 1.0.0 | Download | 58.4 MB | 195bd54189f1126dbaf7e747a6ade87276980159b6701c1d16e5fc68e49169ee |
| Architecture | Version | Download | Size | SHA256 |
|---|---|---|---|---|
| ARM64 | 1.1.0 | Download | 37.1 MB | e67660cb4520f1a305f1111966091c5e22755aaa5e0fcab158b4a2e12245b592 |
| ARM64 | 1.0.3 | Download | 42.2 MB | dddc1848a35aedfe3093d51a1744a16000ecb3c3eb8f436563f1645180b2d693 |
| ARM64 | 1.0.2 | Download | 42.2 MB | 44936faedf4bfa788a9df636ccd6493aaff841e9141a9cf46eae9197af68be12 |
| ARM64 | 1.0.1 | Download | 42.0 MB | 708639d26febc6e3886be7a3bf694b51094350d82847fab1c6ada498f12372a4 |
| ARM64 | 1.0.0 | Download | 57.6 MB | 2405b40ff51678bc1924a44f099630b81c0202f6efe1853959fa6633b93f957f |
| x86 | 1.1.0 | Download | 38.4 MB | adbacf7c119fb727122807d15c6f4706a0bdd30d862c0bd6573f77670a53611b |
| x86 | 1.0.3 | Download | 43.3 MB | a070597ea5ca7dfb647c90a8f9981d82ee5ffcf8e4f9dad27ef4ffc4da6d9fee |
| x86 | 1.0.2 | Download | 43.3 MB | 71caf864f9b3bf448fcec0e4c6f91336c3a785c328e3fa7de7305828a9739352 |
| x86 | 1.0.1 | Download | 43.1 MB | cafbea547d136e52664a481157977df7475a71de4e75ae565f6d8c015c30a32d |
| x86 | 1.0.0 | Download | 58.9 MB | c6ab4d7cb3b2a07c5add089f44ddeee7c21396a33ef4fa74cffa00a414b28bb2 |
Post-Download Steps¶
Renaming the Binary¶
Rename the binary for simpler usage:
Note for x86 Users
Replace arm64 with amd64 in the file name if you are using an x86 architecture.
Making the Binary Executable¶
Files downloaded from the internet are marked with a quarantine attribute by macOS, which prevents them from being run. Remove the quarantine attribute:
Make the binary executable:
On Windows, no additional steps are required.
Verifying the Installation¶
After renaming and adjusting permissions, verify the installation by checking the version:
This command will display the installed version of EventSourcingDB. If the version number matches your expectation, the installation was successful.
For additional details, refer to Deploying the Pre-Built Binary, Managing Configuration and Secrets, and Running EventSourcingDB.