โ–ธ Documentation

Components

AsanagiDB

The graph database server. Speaks Gremlin over the standard TinkerPop3 wire protocol (GraphBinary), LMDB-backed, no JVM required. Accepts connections on a configurable TCP port and a Unix domain socket (UDS) for local-process communication. See Known Limitations for what's not covered yet.

Quick Start

# start with defaults (port 8080, data in ./data/)
asanagidb

# custom config file
asanagidb --config /etc/asanagi/config.yaml

# named instance (multi-tenant)
asanagidb --instance production

Flags

--config, -c <path> Path to YAML config file
--instance <name> Named instance for multi-tenant deployments
--map-size <bytes> LMDB map size (supports KB/MB/GB suffixes, e.g. 4GB)
--uds-path <path> Unix domain socket path (default: /tmp/asanagidb.sock)
--no-uds Disable the Unix domain socket
--no-wal Disable write-ahead log (not recommended in production)
-v, --version Print version and exit

Config File (YAML)

bind_address: "127.0.0.1"
port: 8080
map_size: "4GB"