arcadedb
ArcadeDB Multi-Model Database, one DBMS that supports SQL, Cypher, Gremlin, HTTP/JSON, MongoDB and Redis. ArcadeDB is a conceptual fork of OrientDB, the first Multi-Model DBMS. ArcadeDB supports Vector Embeddings.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ArcadeData/arcadedb with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ArcadeData/arcadedb'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/arcadedata--arcadedb)HTML
<a href="/listings/arcadedata--arcadedb"><img src="/api/listings/arcadedata--arcadedb/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Start ArcadeDB Server with Docker:
docker run --rm -p 2480:2480 \
-v arcadedb-config:/home/arcadedb/config \
-v arcadedb-databases:/home/arcadedb/databases \
-e ARCADEDB_SETTINGS="-Darcadedb.server.rootPassword=playwithdata -Darcadedb.server.defaultDatabases=Imported[root]{import:https://github.com/ArcadeData/arcadedb-datasets/raw/main/orientdb/OpenBeer.gz}" \
arcadedata/arcadedb:latest`--rm` deletes the container's anonymous volumes with it, so the two named volumes keep the imported `OpenBeer` database (`databases`) and the users, groups and API tokens the server writes at runtime (`config`) across runs. For a fresh start, remove them with `docker volume rm arcadedb-config arcadedb-databases`.
Pass database settings in `ARCADEDB_SETTINGS` and any extra JVM flags in `JAVA_OPTS`: Docker replaces an environment variable rather than appending to it, so keeping the two apart leaves the image's own garbage collector and heap sizing (`ARCADEDB_OPTS_GC` and `ARCADEDB_OPTS_MEMORY`) intact. The heap is sized as a percentage of the container memory limit, so `docker run -m 512m` and a multi-GB production container both work without further tuning. The image runs on Java 25, where `server.sh` also enables compact object headers (`-XX:+UseCompactObjectHeaders`), after checking that the JVM accepts the flag (a bare distribution on Java 25 or later does the same); set `ARCADEDB_OPTS_HEADERS` to override it, or to an empty value to opt out.
Now open your browser on http://localhost:2480 and play with [ArcadeDB Studio](https://docs.arcadedb.com/#studio) and the imported `OpenBeer` database to find your favorite beer.
ArcadeDB is cloud-ready with [Docker](https://docs.arcadedb.com/arcadedb/how-to/operations/install-docker) and [Kubernetes](https://docs.arcadedb.com/arcadedb/how-to/operations/kubernetes) support.
You can also [download the latest release](https://github.com/ArcadeData/arcadedb/releases), unpack it on your local hard drive and start the server with `bin/server.sh` or `bin/server.bat` for Windows.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 18 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "arcadedb",
- "owner": {
- "name": "Arcade Data Ltd",
- "email": "info@arcadedata.com",
- "url": "https://arcadedb.com"
- },
- "description": "Official ArcadeDB plugins: connect your AI assistant to your own ArcadeDB server through its built-in MCP endpoint.",
- "plugins": [
- {
- "name": "arcadedb",
- "source": "./claude-plugin",
- "description": "Query, explore and update your own ArcadeDB multi-model database (graph, document, key/value, vector, time-series) through its built-in MCP server.",
- "category": "database",
- "tags": ["database", "graph", "cypher", "sql", "vector", "mcp"]
- }
- ]
- }
README.md · README · 423 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # 
- <h2 align="center">Multi Model DBMS Built for Extreme Performance</h2>
- <p align="center">
- <a href="https://github.com/ArcadeData/arcadedb/releases"><img src="https://img.shields.io/github/v/release/arcadedata/arcadedb?color=%23ff00a0&include_prereleases&label=version&sort=semver"></a>
-
- <a href="https://github.com/sponsors/ArcadeData"><img src="https://img.shields.io/badge/Sponsor-%E2%9D%A4-e25555.svg"></a>
-
- <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-green.svg"></a>
-
- <a href="https://docs.oracle.org/en/java/21/"><img src="https://img.shields.io/badge/Java-%3D21-green.svg"></a>
-
- <a href="https://docs.oracle.org/en/java/17/"><img src="https://img.shields.io/badge/Java-%3D17-green.svg"></a>
-
- <a href="https://api.reuse.software/info/github.com/ArcadeData/arcadedb"><img src="https://api.reuse.software/badge/github.com/ArcadeData/arcadedb"></a>
-
- <a href="https://hub.docker.com/repository/docker/arcadedata/arcadedb/general"><img src="https://img.shields.io/docker/pulls/arcadedata/arcadedb"></a>
-
- <a href="https://deepwiki.com/ArcadeData/arcadedb"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
-
- <a href="bolt/conformance/COMPATIBILITY.md"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ArcadeData/arcadedb/main/bolt/conformance/badge.json" alt="Bolt drivers"></a>
-
- <a href="https://github.com/ArcadeData/arcadedb/actions/workflows/mvn-deploy.yml">
- <img src="https://github.com/ArcadeData/arcadedb/actions/workflows/mvn-deploy.yml/badge.svg">
- </a>
- <a href="https://codecov.io/github/ArcadeData/arcadedb">
- <img src="https://codecov.io/github/ArcadeData/arcadedb/graph/badge.svg?token=0690JAJHIO"/>
- </a>
-
- <a href="https://app.codacy.com/gh/ArcadeData/arcadedb/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage">
- <img src="https://app.codacy.com/project/badge/Coverage/1f971260db1e46638bd3fd91e3ebf668" alt="Codacy Badge">
- </a>
-
- <a href="https://app.codacy.com/gh/ArcadeData/arcadedb/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade">
- <img src="https://app.codacy.com/project/badge/Grade/1f971260db1e46638bd3fd91e3ebf668" alt="Codacy Badge">
- </a>
-
- <a href="https://www.meterian.io/report/gh/ArcadeData/arcadedb">
- <img src="https://www.meterian.io/badge/gh/ArcadeData/arcadedb/security?branch=main">
- </a>
-
- <a href="https://www.meterian.io/report/gh/ArcadeData/arcadedb">
- <img src="https://www.meterian.io/badge/gh/ArcadeData/arcadedb/stability?branch=main">
- </a>
- </p>
- <div align="center">
- <table>
- <tr><th>Test suite</th><th>Runs</th><th>Status</th></tr>
- <tr><td>Java CI - test</td><td>every push to main</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/mvn-test.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/mvn-test.yml/badge.svg?branch=main" alt="Java CI - test"></a></td></tr>
- <tr><td>HA integration (Raft, embedded)</td><td>daily</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/ha-integration-tests.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/ha-integration-tests.yml/badge.svg?branch=main" alt="HA integration (Raft, embedded)"></a></td></tr>
- <tr><td>HA resilience (Docker, fault injection)</td><td>daily</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/ha-resilience-tests.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/ha-resilience-tests.yml/badge.svg?branch=main" alt="HA resilience (Docker, fault injection)"></a></td></tr>
- <tr><td>HA chaos (randomized faults, 60 min)</td><td>weekly</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/ha-chaos-tests.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/ha-chaos-tests.yml/badge.svg?branch=main" alt="HA chaos (randomized faults, 60 min)"></a></td></tr>
- <tr><td>Jepsen (consistency, fault injection)</td><td>daily</td><td><a href="https://github.com/ArcadeData/arcadedb-jepsen/actions/workflows/jepsen.yml"><img src="https://github.com/ArcadeData/arcadedb-jepsen/actions/workflows/jepsen.yml/badge.svg" alt="Jepsen (consistency, fault injection)"></a></td></tr>
- <tr><td>Load tests</td><td>daily</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/load-tests.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/load-tests.yml/badge.svg?branch=main" alt="Load tests"></a></td></tr>
- <tr><td>Bolt driver-version matrix</td><td>daily</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/bolt-nightly.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/bolt-nightly.yml/badge.svg?branch=main" alt="Bolt driver-version matrix"></a></td></tr>
- <tr><td>Native image build</td><td>daily</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/native-image.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/native-image.yml/badge.svg?branch=main" alt="Native image build"></a></td></tr>
- <tr><td>Benchmarks</td><td>weekly</td><td><a href="https://github.com/ArcadeData/arcadedb/actions/workflows/benchmark-tests.yml"><img src="https://github.com/ArcadeData/arcadedb/actions/workflows/benchmark-tests.yml/badge.svg?branch=main" alt="Benchmarks"></a></td></tr>
- </table>
- </div>
- <p align="center">
- <a href="https://discord.gg/w2Npx2B7hZ"><img width="208" height="97" src="https://arcadedb.com/assets/images/discord_button.png" alt="Join Discord"></a>
- </p>
- <p align="center">
- <a href="https://github.com/arcadedata/arcadedb"><img height="25" src="studio/src/main/resources/static/images/social/github.svg" alt="Github"></a>
-
- <a href="https://www.linkedin.com/company/arcadedb/"><img height="25" src="studio/src/main/resources/static/images/social/linkedin.svg" alt="LinkedIn"></a>
-
- <a href="https://bsky.app/profile/arcadedb.bsky.social"><img height="25" src="studio/src/main/resources/static/images/social/bluesky.svg" alt="Bluesky"></a>
-
- <a href="https://twitter.com/arcade_db"><img height="25" src="studio/src/main/resources/static/images/social/twitter.svg" alt="Twitter"></a>
-
- <a href="https://www.youtube.com/@ArcadeDB"><img height="25" src="studio/src/main/resources/static/images/social/youtube.svg" alt="Youtube"></a>
-
- <a href="https://discord.gg/w2Npx2B7hZ"><img height="25" src="studio/src/main/resources/static/images/social/discord.svg" alt="Discord"></a>
-
- <a href="https://stackoverflow.com/questions/tagged/arcadedb"><img height="25" src="studio/src/main/resources/static/images/social/stack-overflow.svg" alt="StackOverflow"></a>
-
- <a href="https://arcadedb.com/blog/"><img height="25" src="studio/src/main/resources/static/images/social/blog.svg" alt="Blog"></a>
- </p>
- ArcadeDB is a Multi-Model DBMS created by Luca Garulli, the same founder
- of [OrientDB](https://github.com/orientechnologies/orientdb),
- after SAP's acquisition. Written from scratch with a brand-new engine made of Alien Technology, ArcadeDB is able to crunch millions
- of records per second on common hardware with minimal resource usage. ArcadeDB reuses OrientDB's SQL engine (heavily modified) and
- some utility classes. It's written in LLJ: Low Level Java - still Java21+ but only using low level APIs to leverage advanced
- mechanical sympathy techniques and reduce Garbage Collector pressure. Highly optimized for extreme performance, it runs
- from a Raspberry Pi to multiple servers on the cloud.
- ArcadeDB is fully transactional DBMS with support for ACID transactions, structured and unstructured data, native graph engine (no
- joins but links between records), full-text indexing, geospatial querying, and advanced security.
- ArcadeDB supports the following models:
- - [Graph Database](https://docs.arcadedb.com#graph-model) (compatible with Neo4j Cypher, Apache Tinkerpop Gremlin and OrientDB SQL)
- - [Document Database](https://docs.arcadedb.com#document-model) (compatible with the MongoDB driver + MongoDB queries and OrientDB
- SQL)
- - [Key/Value](https://docs.arcadedb.com#keyvalue-model) (compatible with the Redis driver)
- - [Search Engine](https://docs.arcadedb.com/#searchengine-model)
- - [Time Series](https://docs.arcadedb.com/#timeseries-model) (with InfluxDB Line Protocol, Prometheus remote_write/read, and PromQL
- support)
- - [Vector Embedding](https://docs.arcadedb.com/#vector-model)
- - [Geospatial](https://docs.arcadedb.com/#geospatial-model)
- ArcadeDB understands multiple languages:
- - [SQL](https://docs.arcadedb.com#sql) (from OrientDB SQL)
- - Neo4j [Cypher (Open Cypher)](https://docs.arcadedb.com#cypher)
- - [Apache Gremlin (Apache Tinkerpop v3.7.x)](https://docs.arcadedb.com#gremlin-api)
- - [GraphQL Language](https://docs.arcadedb.com#graphql)
- - [MongoDB Query Language](https://docs.arcadedb.com#mongodb-query-language)
- ArcadeDB key capabilities:
- - **70+ Built-in Graph Algorithms** — Pathfinding, centrality, community detection, link prediction, graph embeddings, and more —
- all available out of the box
- - **Parallel Query Execution** — SQL queries leverage multiple CPU cores for faster execution on large datasets
- - **Materialized Views** — Pre-computed query results stored and automatically maintained
- - **MCP Server** — Built-in [Model Context Protocol](https://docs.arcadedb.com/#mcp-server) server for AI assistant and LLM
- integration
- - **AI Assistant** — Integrated AI assistant in Studio (Beta) for query help and database management
- - **Geospatial Indexing** — Native spatial queries and proximity searches with `geo.*` SQL functions
- - **TimeSeries** — Columnar storage with Gorilla/Delta-of-Delta compression, InfluxDB/Prometheus ingestion, PromQL queries, Grafana
- integration
- - **Hash Indexes** — Extendible hashing for faster exact-match lookups alongside LSM-Tree indexes
- ArcadeDB can be used as:
- - Embedded from any language on top of the Java Virtual Machine
- - Embedded from Python via bindings: [arcadedb-python](https://github.com/ArcadeData/arcadedb-python) ([documentation](https://docs.arcadedb.com/arcadedb-python/))
- - Remotely by using [HTTP/JSON](https://docs.arcadedb.com#http-json-api)
- - Remotely by using a [Postgres driver](https://docs.arcadedb.com#postgres-driver) (ArcadeDB implements Postgres Wire protocol)
- - Remotely by using a [Redis driver](https://docs.arcadedb.com#redis-query-language) (only a subset of the operations are
- implemented)
- - Remotely by using a [MongoDB driver](https://docs.arcadedb.com#mongodb-query-language) (only a subset of the operations are
- implemented)
- - By AI assistants via the built-in [MCP Server](https://docs.arcadedb.com/arcadedb/reference/mcp/mcp) (Model Context Protocol). For
- Claude Code there is a ready-made [plugin](claude-plugin/README.md):
- `/plugin marketplace add ArcadeData/arcadedb` then `/plugin install arcadedb@arcadedb`
- For more information, see the [documentation](https://docs.arcadedb.com).
- ### Use Cases
- Explore real-world examples in the [arcadedb-usecases](https://github.com/ArcadeData/arcadedb-usecases) repository — self-contained
- projects with Docker Compose, SQL schemas, and runnable demos covering:
- - **Recommendation Engine** — graph traversal + vector similarity + time-series
- - **Knowledge Graphs** — co-authorship and citation networks with full-text search
- - **Graph RAG** — retrieval-augmented generation with LangChain4j and Neo4j Bolt
- - **Fraud Detection** — graph, vector, and time-series signals with Cypher
- - **Real-time Analytics** — IoT and service monitoring with time-series
- - **Social Network Analytics** — materialized view dashboards with polyglot queries
- - **Supply Chain** — multi-tier visibility with PostgreSQL protocol and JavaScript
- ### Getting started in 5 minutes
- Start ArcadeDB Server with Docker:
- ```
- docker run --rm -p 2480:2480 \
- -v arcadedb-config:/home/arcadedb/config \
- -v arcadedb-databases:/home/arcadedb/databases \
- -e ARCADEDB_SETTINGS="-Darcadedb.server.rootPassword=playwithdata -Darcadedb.server.defaultDatabases=Imported[root]{import:https://github.com/ArcadeData/arcadedb-datasets/raw/main/orientdb/OpenBeer.gz}" \
- arcadedata/arcadedb:latest
- ```
- `--rm` deletes the container's anonymous volumes with it, so the two named volumes keep the imported `OpenBeer` database
- (`databases`) and the users, groups and API tokens the server writes at runtime (`config`) across runs. For a fresh start, remove
- them with `docker volume rm arcadedb-config arcadedb-databases`.
- Pass database settings in `ARCADEDB_SETTINGS` and any extra JVM flags in `JAVA_OPTS`: Docker replaces
- an environment variable rather than appending to it, so keeping the two apart leaves the image's own
- garbage collector and heap sizing (`ARCADEDB_OPTS_GC` and `ARCADEDB_OPTS_MEMORY`) intact. The heap is
- sized as a percentage of the container memory limit, so `docker run -m 512m` and a multi-GB
- production container both work without further tuning.
- The image runs on Java 25, where `server.sh` also enables compact object headers (`-XX:+UseCompactObjectHeaders`),
- after checking that the JVM accepts the flag (a bare distribution on Java 25 or later does the same); set
- `ARCADEDB_OPTS_HEADERS` to override it, or to an empty value to opt out.
- Now open your browser on http://localhost:2480 and play with [ArcadeDB Studio](https://docs.arcadedb.com/#studio) and the
- imported `OpenBeer` database to find your favorite beer.
- 
- ArcadeDB is cloud-ready with [Docker](https://docs.arcadedb.com/arcadedb/how-to/operations/install-docker) and [Kubernetes](https://docs.arcadedb.com/arcadedb/how-to/operations/kubernetes)
- support.
- You can also [download the latest release](https://github.com/ArcadeData/arcadedb/releases), unpack it on your local hard drive and
- start the server with `bin/server.sh` or `bin/server.bat` for Windows.
- ### Releases
- There are four variants of (about monthly) releases:
- - `full` - this is the complete package including all modules
- - `minimal` - this package excludes the `gremlin`, `redisw`, `mongodbw`, `graphql` modules
- - `headless` - this package excludes the `gremlin`, `redisw`, `mongodbw`, `graphql`, `studio` modules
- - `base` - core engine, server, and network only — excludes all optional modules (`console`, `gremlin`, `studio`, `redisw`,
- `mongodbw`, `postgresw`, `grpcw`, `graphql`, `metrics`)
- The nightly builds of the repository head can be
- found [here](https://central.sonatype.com/service/rest/repository/browse/maven-snapshots/com/arcadedb/arcadedb-package/).
- You can also build a **custom distribution** with only the modules you need using
- the [Custom Package Builder](https://docs.arcadedb.com/#custom-package-builder):
- ```bash
- curl -fsSL https://github.com/ArcadeData/arcadedb/releases/download/26.3.1/arcadedb-builder.sh | \
- bash -s -- --version=26.3.1 --modules=gremlin,studio
- ```
- Available optional modules: `console`, `gremlin`, `studio`, `redisw`, `mongodbw`, `postgresw`, `grpcw`, `graphql`, `metrics`. The
- builder supports interactive mode, Docker image generation, and offline builds from local Maven repositories.
- An experimental GraalVM **native-image** build (fast startup, low RAM, no JVM required) is also available - see
- [docs/native-image.md](docs/native-image.md) for prerequisites, the build/target matrix, and Docker usage.
- ### Java Versions
- Starting from ArcadeDB 24.4.1 code is compatible with Java 21.
- Java 21 packages are available on [Maven central](https://repo.maven.apache.org/maven2/com/arcadedb/) and docker images
- on [Docker Hub](https://hub.docker.com/r/arcadedata/arcadedb).
- We also support Java 17 on a separate branch `java17` for those who cannot upgrade to Java 21 yet through GitHub packages.
- To use Java 17 inside your project, add the repository to your `pom.xml` and reference dependencies as follows:
- ```xml
- <repositories>
- <repository>
- <name>github</name>
- <id>github</id>
- <url>https://maven.pkg.github.com/ArcadeData/arcadedb</url>
- </repository>
- </repositories>
- <dependencies>
- <dependency>
- <groupId>com.arcadedb</groupId>
- <artifactId>arcadedb-engine</artifactId>
- <version>26.3.1-java17</version>
- </dependency>
- </dependencies>
- ```
- Docker images are available on ghcr.io too:
- ```shell
- docker pull ghcr.io/arcadedata/arcadedb:26.3.1-java17
- ```
- ### Embedding Gremlin alongside the engine
- Always use the `shaded` classifier for gremlin when embedding it, whether alongside
- `arcadedb-engine` or on its own. Its ANTLR runtime is relocated into a private package, so it
- never collides with the engine's ANTLR 4.13.2 on a shared classpath.
- The plain `arcadedb-gremlin` jar resolves ANTLR to the engine's 4.13.2 (pulled transitively via
- `arcadedb-engine`), which the engine's SQL/Cypher parsers require. TinkerPop's Gremlin
- string-query parser ships a precompiled ANTLR 4.9.1 parser that only deserializes against the
- relocated runtime inside the `shaded` jar, so the plain jar alone will not run Gremlin string
- queries - use the `shaded` classifier.
- ```xml
- <dependency>
- <groupId>com.arcadedb</groupId>
- <artifactId>arcadedb-engine</artifactId>
- <version>26.8.1</version>
- </dependency>
- <dependency>
- <groupId>com.arcadedb</groupId>
- <artifactId>arcadedb-gremlin</artifactId>
- <version>26.8.1</version>
- <classifier>shaded</classifier>
- </dependency>
- ```
- ### Building and Testing
- Build the entire project (skipping tests):
- ```bash
- mvn clean install -DskipTests
- ```
- Build the Docker image (skipping tests):
- ```bash
- mvn clean install -DskipTests -Pdocker
- ```
- #### Running Unit Tests:
- Run the full unit test suite:
- ```bash
- mvn test
- ```
- Some tests are tagged to indicate their cost:
- - `slow` - functional tests that take noticeably long (large batches, multi-second elapsed time, big payloads)
- - `benchmark` - microbenchmarks not intended for regular CI runs; excluded by default (see below)
- `benchmark`-tagged tests are excluded by default, so a plain `mvn test` already skips them. To also skip
- `slow` tests and run only the fast ones:
- ```bash
- mvn test -DexcludedGroups="slow,benchmark"
- ```
- To run only a specific tag (e.g. benchmark tests in isolation), clear the default exclusion or it
- cancels out the selection and nothing runs:
- ```bash
- mvn test -Dgroups="benchmark" -DexcludedGroups=
- ```
- #### Running Integration Tests:
- Run all the integration tests (requires Docker):
- ```bash
- mvn verify -Pintegration
- ```
- Run integration tests excluding the end-to-end, load, and HA tests:
- ```bash
- mvn verify -Pintegration -pl !e2e,!load-tests,!e2e-ha
- ```
- #### Running End-to-End Tests:
- All end-to-end tests (requires Docker):
- ```bash
- mvn verify -Pintegration -pl e2e,load-tests,e2e-ha
- ```
- #### Test Suites at a Glance
- The codebase is covered by several complementary test suites, each with a distinct scope. The "CI" column says when each one
- runs; the scheduled ones have a status badge at the top of this page.
- | Suite | How it runs | CI | Scope |
- |-------|-------------|----|-------|
- | **Unit tests** | `mvn test` (`*Test`) | every PR | Fast, in-process tests of a single component in isolation: engine internals (storage, pages, WAL, indexes, serialization), query parsing and execution (SQL, Cypher, Gremlin, GraphQL), schema, graph traversals, and security. The bulk of coverage; no external services required. CI splits them into lanes by JUnit tag: `slow` (long functional tests) and `vector` (LSM vector-index rebuilds) run in their own lanes, `benchmark` is excluded by default. |
- | **Integration tests** | `mvn verify -Pintegration` (`*IT`) | every PR | Tests spanning multiple components or a running server within the same JVM/module: HTTP/REST API, wire protocols (Postgres, MongoDB, Redis, Bolt, gRPC), and cross-module behavior. Some require Docker. |
- | **HA integration (`ha-raft`)** | `mvn verify -Pintegration -pl ha-raft` | daily | Raft high-availability clusters of several servers started inside one JVM: replication, leader election, schema and security propagation, snapshot install, and catch-up of lagging followers. Moved out of the PR pipeline because of its length. |
- | **End-to-end (`e2e`)** | `mvn verify -Pintegration -pl e2e` | every PR | Black-box tests against a real ArcadeDB server in a Docker container (Testcontainers), exercising it the way external clients do: JDBC/Postgres queries, the remote Java API, server-side JavaScript functions, and the Bolt and gRPC drivers. |
- | **Load tests (`load-tests`)** | `mvn verify -Pintegration -pl load-tests` | daily | Throughput and stability under sustained concurrent workloads against single-server and three-node clusters in containers, including high-volume document and time-series ingestion. Verifies no data loss or corruption under contention. |
- | **HA end-to-end (`e2e-ha`)** | `mvn verify -Pintegration -pl e2e-ha` | daily | Resilience and correctness of the Raft cluster under scripted failures: leader failover, rolling restarts, split-brain, network partitions/delay/packet loss, replication convergence, and cluster-wide operations (backup/restore, import, drop database, user management). Uses Testcontainers and fault injection (Toxiproxy). |
- | **HA chaos (`HaChaosIT`)** | `mvn verify -Pintegration -pl e2e-ha -Dit.test=HaChaosIT -Dfailsafe.excludedGroups=` | weekly | Long randomized run (60 minutes by default) against a containerized cluster: concurrent writers while a seeded scheduler injects faults (kill, stop, rolling restart, pause, isolate, split, latency, packet loss, and a follower frozen for more than 60 s that must recover without reformatting its Raft storage), and every acknowledged write is checked against all replicas after each step. Each run prints its seed so a failure can be replayed with `-Dchaos.seed=...`; tune with `-Dchaos.nodes`, `-Dchaos.duration`, `-Dchaos.faults`, `-Dchaos.writers`. Tagged `chaos`, so the plain `e2e-ha` run skips it. |
- | **Benchmarks** | `mvn verify -Dgroups=benchmark -DexcludedGroups=` | weekly | Microbenchmarks and comparison runs (`@Tag("benchmark")`). They measure rather than assert, and are excluded from every other run. |
- | **Python client (`e2e-python`)** | `cd e2e-python && pytest tests/` | every PR | Verifies the Postgres wire protocol against real Python clients (`psycopg2`, `asyncpg`) and the SQLAlchemy ORM, and the Bolt protocol against the official `neo4j` driver, running against a server in a Docker container (Testcontainers). |
- | **JavaScript client (`e2e-js`)** | `cd e2e-js && npm install && npm test` | every PR | Verifies Node.js client compatibility over the Bolt (`neo4j-driver`) and Postgres (`pg`) protocols, running against a server in a Docker container (Jest + Testcontainers). |
- | **C# client (`e2e-csharp`)** | `cd e2e-csharp/ArcadeDB.E2ETests && dotnet test` | every PR | Verifies the Postgres wire protocol (`Npgsql`) and the Bolt protocol (`Neo4j.Driver`, plain and TLS) from .NET, running against a server in a Docker container (xUnit + Testcontainers). |
- | **Go client (`e2e-go`)** | `cd e2e-go && go test ./...` | every PR | Bolt conformance with the official `neo4j-go-driver`, plain and TLS, against a server in a Docker container. Implements the shared scenario spec in [`bolt/conformance/spec.yaml`](bolt/conformance/spec.yaml), like the other client suites. |
- | **Bolt driver matrix** | `bolt-nightly.yml` workflow | daily | Reruns the Bolt tests of the JavaScript, Python, C# and Go suites against several released versions of each official driver, and publishes the result in [COMPATIBILITY.md](bolt/conformance/COMPATIBILITY.md). |
- | **Studio (`e2e-studio`)** | `cd e2e-studio && npm install && npm test` | every PR | Browser tests of the Studio web UI with Playwright: database creation, queries and charts, graph view (styling, context menu, export), table views, and vector search. |
- ### Community
- Join our growing community around the world, for ideas, discussions and help regarding ArcadeDB.
- - Chat live with us on [Discord](https://discord.gg/w2Npx2B7hZ)
- - Follow us on [Twitter](https://twitter.com/arcade_db)
- - or on [Bluesky](https://bsky.app/profile/arcadedb.bsky.social)
- - Connect with us on [LinkedIn](https://www.linkedin.com/products/arcadedb)
- - or on [Facebook](https://www.facebook.com/arcadedb)
- - Questions tagged `#arcadedb` on [Stack Overflow](https://stackoverflow.com/questions/tagged/arcadedb)
- - View our official [Blog](https://arcadedb.com/blog/)
- ### Security
- For security issues kindly email us at support@arcadedb.com instead of posting a public issue on GitHub.
- ### License and Attribution
- ArcadeDB is Free for any usage and licensed under the liberal [Open Source Apache 2 license](LICENSE). We are committed to remaining
- **Open Source Forever** — see our [Governance](GOVERNANCE.md) for the structural guarantees that make this more than a promise. If
- you need commercial support, or you need to have an issue fixed ASAP, check our [pricing page](https://arcadedb.com/pricing.html).
- For third-party attributions and copyright notices, see:
- - [NOTICE](NOTICE) - Required legal attributions
- - [ATTRIBUTIONS.md](ATTRIBUTIONS.md) - Detailed third-party acknowledgments
- - [LICENSE](LICENSE) - Full license text
- - [GOVERNANCE.md](GOVERNANCE.md) - License guarantee and project governance
- ### Thanks To
- <a href="https://www.yourkit.com"><img src="https://www.yourkit.com/images/yklogo.png"></a> for providing YourKit Profiler to our
- committers.
- ### Contributing
- We would love for you to get involved with ArcadeDB project.
- If you wish to help, you can learn more about how you can contribute to this project in the [contribution guide](CONTRIBUTING.md).
- Have fun with data!
- The ArcadeDB Team
- ## Stargazers over time
- <a href="https://www.star-history.com/#arcadedata/arcadedb&Date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=arcadedata/arcadedb&type=Date&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=arcadedata/arcadedb&type=Date" />
- <img alt="Stargazers over time" src="https://api.star-history.com/svg?repos=arcadedata/arcadedb&type=Date" />
- </picture>
- </a>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.