Getting started

Embedded

Install EchoVault with: go get github.com/echovault/echovault.

Here's an example of using EchoVault as an embedded library. You can access all of EchoVault's commands using an ergonomic API.

func main() {
  server, err := echovault.NewEchoVault()

  if err != nil {
    log.Fatal(err)
  }

  _, _, _ = server.Set("key", "Hello, world!", echovault.SETOptions{})

  v, _ := server.Get("key")
  fmt.Println(v) // Hello, world!

  // (Optional): Listen for TCP connections on this EchoVault instance.
  server.Start()
}

An embedded EchoVault instance can still be part of a cluster, and the changes triggered from the API will be consistent across the cluster.

If you want to configure the EchoVault instance, you can modify retrieve the default config and update its properties to suit your requirements.

conf := echovault.DefaultConfig()
conf.ServerID = "ServerInstance1"

server, err := echovault.NewEchoVault(
  echovault.WithConfig(conf),
)

if err != nil {
  log.Fatal(err)
}

For more information on the available configuration values, check out the configuration page.

You can also pass in a custom context using the WithContext option.

ctx := context.WithValue(context.Background(), "name", "default")

server, err := echovault.NewEchoVault(
  echovault.WithContext(ctx),
)

if err != nil {
  log.Fatal(err)
}

Client-Server

Homebrew

To install via homebrew, run:

1. brew tap echovault/echovault
2. brew install echovault/echovault/echovault

Once installed, you can run the server with the following command: echovault --bind-addr=localhost --data-dir="path/to/persistence/directory"

Docker

docker pull echovault/echovault

The full list of tags can be found here.

Container Registry

docker pull ghcr.io/echovault/echovault

The full list of tags can be found here.

Binaries

You can download the binaries by clicking on a release tag and downloading the binary for your system.

Clients

EchoVault uses RESP, which makes it compatible with existing Redis clients.