EliasDB is a graph-based database.
Matthias Ladkau a7ae9f9fa5 chore: Adding some swagger documentation | 4 lat temu | |
---|---|---|
api | 4 lat temu | |
cli | 5 lat temu | |
cluster | 4 lat temu | |
config | 4 lat temu | |
console | 4 lat temu | |
eql | 5 lat temu | |
examples | 4 lat temu | |
graph | 4 lat temu | |
graphql | 5 lat temu | |
hash | 5 lat temu | |
integration | 5 lat temu | |
server | 4 lat temu | |
storage | 4 lat temu | |
.gitignore | 4 lat temu | |
CHANGELOG.md | 4 lat temu | |
Dockerfile | 5 lat temu | |
Jenkinsfile | 4 lat temu | |
LICENSE | 5 lat temu | |
Makefile | 4 lat temu | |
NOTICE | 5 lat temu | |
README.md | 4 lat temu | |
cluster.md | 4 lat temu | |
cluster_join.png | 4 lat temu | |
cluster_term.png | 4 lat temu | |
cluster_working.png | 4 lat temu | |
eliasdb_design.md | 4 lat temu | |
embedding.md | 5 lat temu | |
eql.md | 5 lat temu | |
go.mod | 5 lat temu | |
go.sum | 5 lat temu | |
graphql.md | 5 lat temu | |
pack_binary.sh | 4 lat temu | |
swagger.json | 4 lat temu |
EliasDB is a graph-based database which aims to provide a lightweight solution for projects which want to store their data as a graph.
You can download a pre-compiled package for Windows (win64) or Linux (amd64) here.
Extract it and execute the executable with:
eliasdb server
The executable should automatically create 3 subfolders and a configuration file. It should start an HTTPS server on port 9090. To see a terminal point your webbrowser to:
https://localhost:9090/db/term.html
After accepting the self-signed certificate from the server you should see a web terminal. EliasDB can be stopped with a simple CTRL+C or by overwriting the content in eliasdb.lck with a single character.
You can pull the latest docker image of EliasDB from Dockerhub:
docker pull krotik/eliasdb
Create an empty directory, change into it and run the following to start the server:
docker run --user $(id -u):$(id -g) -v $PWD:/data -p 9090:9090 krotik/eliasdb server
This exposes port 9090 from the container on the local machine. All runtime related files are written to the current directory as the current user/group.
Connect to the running server with a console by running:
docker run --rm --network="host" -it -v $PWD:/data --user $(id -u):$(id -g) -v $PWD:/data krotik/eliasdb console
To get an idea of what EliasDB is about have a look at the tutorial. This tutorial will cover the basics of EQL and show how data is organized.
There is a separate tutorial on using ELiasDB with GraphQL.
The terminal uses a REST API to communicate with the backend. The REST API can be browsed using a dynamically generated swagger.json definition (https://localhost:9090/db/swagger.json). You can browse the API of EliasDB's latest version here.
EliasDB supports to be run in a cluster by joining multiple instances of EliasDB together. You can read more about it here.
The main EliasDB executable has two main tools:
Usage of ./eliasdb <tool>
EliasDB graph based database
Available commands:
console EliasDB server console
server Start EliasDB server
The most important one is server which starts the database server. The server has several options:
Usage of ./eliasdb server [options]
-export string
Export the current database to a zip file
-help
Show this help message
-import string
Import a database from a zip file
-no-serv
Do not start the server after initialization
Once the server is started the console tool can be used to interact with the server. The options of the console tool are:
Usage of ./eliasdb console [options]
-exec string
Execute a single line and exit
-file string
Read commands from a file and exit
-help
Show this help message
-host string
Host of the EliasDB server (default "localhost")
-port string
Port of the EliasDB server (default "9090")
On the console type 'q' to exit and 'help' to get an overview of available commands:
Command Description
export Exports the last output.
find Do a full-text search of the database.
help Display descriptions for all available commands.
info Returns general database information.
part Displays or sets the current partition.
ver Displays server version information.
It is also possible to directly run EQL and GraphQL queries on the console. Use the arrow keys to cycle through the command history.
EliasDB uses a single configuration file called eliasdb.config.json. After starting EliasDB for the first time it should create a default configuration file. Available configurations are:
Configuration Option | Description |
---|---|
ClusterConfigFile | Cluster configuration file. |
ClusterLogHistory | File which is used to store the console history. |
ClusterStateInfoFile | File which is used to store the cluster state. |
CookieMaxAgeSeconds | Lifetime for cookies used by EliasDB. |
EnableAccessControl | Flag if access control for EliasDB should be enabled. This provides user authentication and authorization features. |
EnableCluster | Flag if EliasDB clustering support should be enabled. EXPERIMENTAL! |
EnableClusterTerminal | Flag if the cluster terminal file /web/db/cluster.html should be created. |
EnableReadOnly | Flag if the datastore should be open read-only. |
EnableWebFolder | Flag if the files in the webfolder /web should be served up by the webserver. If false only the REST API is accessible. |
EnableWebTerminal | Flag if the web terminal file /web/db/term.html should be created. |
HTTPSCertificate | Name of the webserver certificate which should be used. A new one is created if it does not exist. |
HTTPSHost | Hostname the webserver should listen to. This host is also used in the dynamically generated swagger definition. |
HTTPSKey | Name of the webserver private key which should be used. A new one is created if it does not exist. |
HTTPSPort | Port on which the webserver should listen on. |
LocationAccessDB | File which is used to store access control information. This file can be edited while the server is running and changes will be picked up immediately. |
LocationDatastore | Directory for datastore files. |
LocationHTTPS | Directory for the webserver's SSL related files. |
LocationUserDB | File which is used to store (hashed) user passwords. |
LocationWebFolder | Directory of the webserver's webfolder. |
LockFile | Lockfile for the webserver which will be watched duing runtime. Replacing the content of this file with a single character will shutdown the webserver gracefully. |
MemoryOnlyStorage | Flag if the datastore should only be kept in memory. |
ResultCacheMaxAgeSeconds | EQL queries create result sets which are cached. The value describes the amount of time in seconds a result is kept in the cache. |
ResultCacheMaxSize | EQL queries create result sets which are cached. The value describes the number of results which can be kept in the cache. |
Note: It is not (and will never be) possible to access the REST API via HTTP.
It is possible to enforce access control by enabling the EnableAccessControl
configuration option. When started with enabled access control EliasDB will only allow known users to connect. Users must authenticate with a password before connecting to the web interface or the REST API. On the first start with the flag enabled the following users are created by default:
Username | Default Password | Groups | Description |
---|---|---|---|
elias | elias | admin/public | Default Admin |
johndoe | doe | public | Default unprivileged user |
Users can be managed from the console. Please do either delete the default users or change their password after starting EliasDB.
Users are organized in groups and permissions are assigned to groups. Permissions are given to endpoints of the REST API. The following permissions are available:
Type | Allowed HTTP Request Type | Description |
---|---|---|
Create | Post | Creating new data |
Read | Get | Read data |
Update | Put | Modify existing data |
Delete | Delete | Delete data |
The default group permissions are:
Group | Path | Permissions |
---|---|---|
admin | /db/* | CRUD |
public | / | -R-- |
/css/* | -R-- |
|
/db/* | -R-- |
|
/img/* | -R-- |
|
/js/* | -R-- |
|
/vendor/* | -R-- |
To build EliasDB from source you need to have Go installed (go >= 1.12):
Create a directory, change into it and run:
git clone https://devt.de/krotik/eliasdb/ .
You can build EliasDB's executable with:
go build cli/eliasdb.go
EliasDB can be build as a secure and compact Docker image.
Create a directory, change into it and run:
git clone https://devt.de/krotik/eliasdb/ .
You can now build the Docker image with:
docker build --tag krotik/eliasdb .
EliasDB source code is available under the Mozilla Public License.