# 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:

```shell
docker pull thenativeweb/eventsourcingdb
```

### 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`:

```shell
docker pull thenativeweb/eventsourcingdb:1.2.0
```

A complete list of available versions is available on **[Docker Hub](https://hub.docker.com/r/thenativeweb/eventsourcingdb)**.

### Verifying the Installation

After downloading, verify the installation by checking the version:

```shell
docker run thenativeweb/eventsourcingdb 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](/docs/eventsourcingdb/v1.1/deploying-with-docker)**, **[Deploying on Kubernetes](/docs/eventsourcingdb/v1.1/deploying-on-kubernetes)**, **[Managing Configuration and Secrets](/docs/eventsourcingdb/v1.1/managing-configuration-and-secrets)**, and **[Running EventSourcingDB](/docs/eventsourcingdb/v1.1/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:

**macOS**

| Architecture | Version | Download | Size | SHA256 |
|--------------|---------|----------|------|--------|
| ARM64 | 1.2.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.2.0/eventsourcingdb-darwin-arm64)** | 42.9 MB | `15201a5215a45e8bd7edb80275c32fa16ba37ab9fe4e06be2daf95e747bcfa76` |
| x86 | 1.2.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.2.0/eventsourcingdb-darwin-amd64)** | 43.8 MB | `33c15c1bfe4093ba2036549d332755b52fe0b06243edc6f07c76071876845b6d` |

**Linux**

| Architecture | Version | Download | Size | SHA256 |
|--------------|---------|----------|------|--------|
| ARM64 | 1.2.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.2.0/eventsourcingdb-linux-arm64)** | 42.0 MB | `fce6c8efcf63aa43f8c273c87eaed3b913bfd4366641d9b37c7f402fc5c0d82e` |
| x86 | 1.2.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.2.0/eventsourcingdb-linux-amd64)** | 43.2 MB | `143afa9a7d498911bd8d9373fb3fa1000cae70ce40575ae60ee119cb98d9f365` |

**Windows**

| Architecture | Version | Download | Size | SHA256 |
|--------------|---------|----------|------|--------|
| ARM64 | 1.2.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.2.0/eventsourcingdb-windows-arm64.exe)** | 42.5 MB | `241c13cebbbe30c99f22a0222a7e8fd3a3bb5500f3a2204122b30ed6e18e29d2` |
| x86 | 1.2.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.2.0/eventsourcingdb-windows-amd64.exe)** | 43.9 MB | `3298d5e1fabd718912bcd8ea6a5d97598dbb22d063d63eab4fb407e9c5776a77` |

### Downloading a Specific Version

To download a specific version of EventSourcingDB, expand the list below:

> **Previous Versions**
>
> **macOS**
>
> | Architecture | Version | Download | Size | SHA256 |
> |--------------|---------|----------|------|--------|
> | ARM64 | 1.1.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.1.0/eventsourcingdb-darwin-arm64)** | 37.4 MB | `9404d314687b29a58eab1649a2db052450f28cbeab966ef2b959ba1b7d4113af` |
> | ARM64 | 1.0.3 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.3/eventsourcingdb-darwin-arm64)** | 42.7 MB | `ef09eb25205e4994f44e8b490d47b3d0ae5497be13b28654f1ecb6e4206a86b6` |
> | ARM64 | 1.0.2 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.2/eventsourcingdb-darwin-arm64)** | 42.6 MB | `2f9e9eb26ec8ee8bf00744eabb1a54424eae150e451d1035ba6c3b7537d40028` |
> | ARM64 | 1.0.1 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.1/eventsourcingdb-darwin-arm64)** | 42.4 MB | `edef81d66fc4d005182ffe80a0767c2abe6f1da8f2cbad9cc8855dffc76a3356` |
> | ARM64 | 1.0.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.0/eventsourcingdb-darwin-arm64)** | 57.9 MB | `d2183c07f9b24a8987f379b899d502e3d73f73abb49ba53b94e94f4e456fc26d` |
> | x86 | 1.1.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.1.0/eventsourcingdb-darwin-amd64)** | 38.3 MB | `9834b26a5c7b5326347172a72f05e38411749b18a57d4d7cc2928f50031fad39` |
> | x86 | 1.0.3 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.3/eventsourcingdb-darwin-amd64)** | 43.2 MB | `e79aa0a9813ced6312225391fd72d6ff87eb866e90efe610784e6e889c2c41ef` |
> | x86 | 1.0.2 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.2/eventsourcingdb-darwin-amd64)** | 43.2 MB | `77c861656c214dd72684147bc6a7ea42ea359828591382d0d277afcf3c304a0d` |
> | x86 | 1.0.1 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.1/eventsourcingdb-darwin-amd64)** | 43.0 MB | `3744758d7b36339bfde0d5eb22fde1bb3c8d2131a3eaaafb5a016fc25c894dfb` |
> | x86 | 1.0.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.0/eventsourcingdb-darwin-amd64)** | 58.6 MB | `82c2e7fce8efad0fd10b6e452e50b6d3fd8bb339446e5b2c45704736458b6d49` |
>
> **Linux**
>
> | Architecture | Version | Download | Size | SHA256 |
> |--------------|---------|----------|------|--------|
> | ARM64 | 1.1.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.1.0/eventsourcingdb-linux-arm64)** | 36.7 MB | `d1d31a39944f83989dd3b30b8069018706489a474fc3669f2599523336b9ab15` |
> | ARM64 | 1.0.3 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.3/eventsourcingdb-linux-arm64)** | 41.8 MB | `f830d3f9188ba1d1d99871ad12ee733933931cecd89d54dcf079b1ff2163a802` |
> | ARM64 | 1.0.2 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.2/eventsourcingdb-linux-arm64)** | 41.8 MB | `e54930fc1d1d9c422f95d5378676f5489ba7770ba38327ac70ae63bdea8e3907` |
> | ARM64 | 1.0.1 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.1/eventsourcingdb-linux-arm64)** | 41.6 MB | `c9f685a0a34dd9d06adb57c6110d3eb7dcbc96674d089a243e537ee9641afe86` |
> | ARM64 | 1.0.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.0/eventsourcingdb-linux-arm64)** | 57.3 MB | `3d7657b0e8840c92f5db91a5a578264d18f8519acfb5218a1abcd3e51213e9da` |
> | x86 | 1.1.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.1.0/eventsourcingdb-linux-amd64)** | 37.8 MB | `0e662724f5b1d3cd66769798a77c9dfec6e799ff86e1975bd2415caaa39d7a1e` |
> | x86 | 1.0.3 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.3/eventsourcingdb-linux-amd64)** | 42.7 MB | `9c1112bce1803e9d194cf298a9fd18b8192a266c6c10e44598f03ad08a0deefa` |
> | x86 | 1.0.2 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.2/eventsourcingdb-linux-amd64)** | 42.7 MB | `3f794345673d1db33bfae6cafa3ee0811302c46ba9d3305f315a3799a07398c3` |
> | x86 | 1.0.1 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.1/eventsourcingdb-linux-amd64)** | 42.5 MB | `56fd02d1aabd1193eed00f3576dd51e0195cdebc0569f2c160c8b628f4b2f39a` |
> | x86 | 1.0.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.0/eventsourcingdb-linux-amd64)** | 58.4 MB | `195bd54189f1126dbaf7e747a6ade87276980159b6701c1d16e5fc68e49169ee` |
>
> **Windows**
>
> | Architecture | Version | Download | Size | SHA256 |
> |--------------|---------|----------|------|--------|
> | ARM64 | 1.1.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.1.0/eventsourcingdb-windows-arm64.exe)** | 37.1 MB | `e67660cb4520f1a305f1111966091c5e22755aaa5e0fcab158b4a2e12245b592` |
> | ARM64 | 1.0.3 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.3/eventsourcingdb-windows-arm64.exe)** | 42.2 MB | `dddc1848a35aedfe3093d51a1744a16000ecb3c3eb8f436563f1645180b2d693` |
> | ARM64 | 1.0.2 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.2/eventsourcingdb-windows-arm64.exe)** | 42.2 MB | `44936faedf4bfa788a9df636ccd6493aaff841e9141a9cf46eae9197af68be12` |
> | ARM64 | 1.0.1 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.1/eventsourcingdb-windows-arm64.exe)** | 42.0 MB | `708639d26febc6e3886be7a3bf694b51094350d82847fab1c6ada498f12372a4` |
> | ARM64 | 1.0.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.0/eventsourcingdb-windows-arm64.exe)** | 57.6 MB | `2405b40ff51678bc1924a44f099630b81c0202f6efe1853959fa6633b93f957f` |
> | x86 | 1.1.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.1.0/eventsourcingdb-windows-amd64.exe)** | 38.4 MB | `adbacf7c119fb727122807d15c6f4706a0bdd30d862c0bd6573f77670a53611b` |
> | x86 | 1.0.3 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.3/eventsourcingdb-windows-amd64.exe)** | 43.3 MB | `a070597ea5ca7dfb647c90a8f9981d82ee5ffcf8e4f9dad27ef4ffc4da6d9fee` |
> | x86 | 1.0.2 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.2/eventsourcingdb-windows-amd64.exe)** | 43.3 MB | `71caf864f9b3bf448fcec0e4c6f91336c3a785c328e3fa7de7305828a9739352` |
> | x86 | 1.0.1 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.1/eventsourcingdb-windows-amd64.exe)** | 43.1 MB | `cafbea547d136e52664a481157977df7475a71de4e75ae565f6d8c015c30a32d` |
> | x86 | 1.0.0 | **[Download](https://eventsourcingdb.s3.fr-par.scw.cloud/1.0.0/eventsourcingdb-windows-amd64.exe)** | 58.9 MB | `c6ab4d7cb3b2a07c5add089f44ddeee7c21396a33ef4fa74cffa00a414b28bb2` |

### Post-Download Steps

#### Renaming the Binary

Rename the binary for simpler usage:

**macOS**

```shell
mv eventsourcingdb-darwin-arm64 eventsourcingdb
```

**Linux**

```shell
mv eventsourcingdb-linux-arm64 eventsourcingdb
```

**Windows**

```shell
ren eventsourcingdb-windows-arm64.exe eventsourcingdb.exe
```

> **Note for x86 Users**
>
> **Replace `arm64` with `amd64`** in the file name if you are using an x86 architecture.

#### Making the Binary Executable

**macOS**

Files downloaded from the internet are marked with a quarantine attribute by macOS, which prevents them from being run. **Remove the quarantine attribute**:

```shell
xattr -d com.apple.quarantine eventsourcingdb
```

**Make the binary executable**:

```shell
chmod a+x eventsourcingdb
```

**Linux**

**Make the binary executable**:

```shell
chmod a+x eventsourcingdb
```

**Windows**

Files downloaded from the internet are marked with a "Mark of the Web", which makes SmartScreen block the binary as coming from an unknown publisher. **Remove that mark**:

```shell
Unblock-File .\eventsourcingdb.exe
```

If SmartScreen still shows a **"Windows protected your PC"** dialog on first run, choose **More info** and then **Run anyway**.

### Verifying the Installation

After renaming and adjusting permissions, verify the installation by checking the version:

**macOS**

```shell
./eventsourcingdb version
```

**Linux**

```shell
./eventsourcingdb version
```

**Windows**

```shell
eventsourcingdb 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](/docs/eventsourcingdb/v1.1/deploying-the-pre-built-binary)**, **[Managing Configuration and Secrets](/docs/eventsourcingdb/v1.1/managing-configuration-and-secrets)**, and **[Running EventSourcingDB](/docs/eventsourcingdb/v1.1/running-eventsourcingdb)**.