Installation

Echo DB can be installed in two ways. The recommended and primary method is via Docker. You can also build and run it from source.

Option 1: Docker (Recommended)

This is the easiest and intended way to run Echo DB.

Pull the Image

docker pull rechesoares/echodb:0.1.0

Run Echo DB

docker run -p 6380:6380 rechesoares/echodb:0.1.0

Echo DB will start listening on port 6380.

Option 2: Build from Source

Use this if you want to modify the source or run Echo DB without Docker.

Prerequisites

• Go 1.25.2 or higher
• Make (optional, for Makefile commands)

Clone the Repository

git clone https://github.com/reche13/echodb.git
cd echodb

Build

You can build Echo DB using Go directly or the provided Makefile.

Using Go:

go build -o bin/echodb cmd/main.go

Using Makefile:

make build

This will create a binary in the bin/ directory.

Run

Using Go:

go run cmd/main.go

Using Makefile:

make run
# or
make start  # builds and runs

Configuration

Create a config.yaml file in the configs/ directory or in the current working directory. See the Configuration section for details on all available options.

Verify Installation

Once Echo DB is running, you should see:

███████╗ ██████╗██╗  ██╗ ██████╗
██╔════╝██╔════╝██║  ██║██╔═══██╗
█████╗  ██║     ███████║██║   ██║
██╔══╝  ██║     ██╔══██║██║   ██║
███████╗╚██████╗██║  ██║╚██████╔╝
╚══════╝ ╚═════╝╚═╝  ╚═╝ ╚═════╝

EchoDB — In-Memory Data Store
Version: 0.1.0
Status : Starting up...

2026/01/08 05:54:07 Listening on  0.0.0.0:6380

Test the connection using redis-cli:

redis-cli -p 6380
> PING
PONG

Next Steps

• Connecting to ECHO DB - Learn how to connect
• Configuration - Configure your instance