arangodb · Simran-B · Aug 1, 2025 · Apr 30, 2025 · Apr 30, 2025 · Jun 10, 2025
diff --git a/README.md b/README.md
@@ -425,6 +425,15 @@ Available attributes:
 - `class`: CSS classes to apply
 - `style`: CSS inline styles to apply
 
+#### Keyboard shortcuts
+
+To document hotkeys and key combinations to press in a terminal or graphical
+user interface, use the `kbd` shortcode:
+
+```markdown
+Hit {{< kbd "Ctrl Return" >}} respectively {{< kbd "Cmd Return" >}} to run the query.
+```
+
 #### Cards
 
 To prominently link to other content, you may use cards:

diff --git a/site/content/3.13/_index.md b/site/content/3.13/_index.md
@@ -26,8 +26,13 @@ ArangoDB's Query Language AQL lets you use graphs, JSON documents, and search
 via a single, composable query language.
 {{% /card %}}
 
-{{% card title="Data Science" link="data-science/" %}}
-Discover the graph analytics and machine learning features of ArangoDB.
+{{% card title="GenAI & Data Science" link="data-science/" %}}
+Discover the graph-powered machine learning and GraphRAG features of ArangoDB.
+{{% /card %}}
+
+{{% card title="ArangoDB Platform" link="components/platform/" %}}
+The ArangoDB Platform is the umbrella for hosting the entire ArangoDB offering
+of products, including GraphML and GraphRAG.
 {{% /card %}}
 
 {{% card title="Deploy" link="deploy/" %}}

diff --git a/site/content/3.13/about-arangodb/features/_index.md b/site/content/3.13/about-arangodb/features/_index.md
@@ -21,6 +21,10 @@ aliases:
 
 See the full [Feature list of the ArangoDB core database system](core.md).
 
+For a scalable architecture based on Kubernetes that supports the full offering
+of ArangoDB including graph-powered machine learning and GenAI features, see
+the [Feature list of the ArangoDB Platform](platform.md).
+
 ## On-premises versus Cloud
 
 ### Fully managed cloud service

diff --git a/site/content/3.13/about-arangodb/features/platform.md b/site/content/3.13/about-arangodb/features/platform.md
@@ -0,0 +1,57 @@
+---
+title: Feature list of the ArangoDB Platform
+menuTitle: ArangoDB Platform
+weight: 10
+description: >-
+  The ArangoDB Platform is a scalable architecture that gets you all features
+  of ArangoDB including graph-powered machine learning and GenAI as a single
+  solution with a unified interface
+---
+For in-depth information about the ArangoDB Platform as a whole and how to
+deploy and use it, see [The ArangoDB Platform](../../components/platform.md).
+
+## Architecture
+
+- **Core Database**: The ArangoDB database system forms the solid core
+  of the ArangoDB Platform.
+
+- **Kubernetes**: An open-source container orchestration system for automating
+  software deployment, scaling, and management designed by Google. It is the
+  autopilot for operating ArangoDB clusters and the additional Platform services.
+
+- **Helm**: A package manager for Kubernetes that enables consistent, repeatable
+  installations and version control.
+
+- **Envoy**: A high-performance service proxy that acts as the gateway for the
+  ArangoDB Platform for centralizing authentication and routing.
+
+- **Web interface**: The Platform includes a unified, browser-based UI that lets
+  you access its features in an intuitive way. Optional products like the
+  GenAI Suite seamlessly integrate into the UI if installed.
+
+## Features
+
+- [**ArangoDB Core**](core.md): The ArangoDB database system with support for
+  graphs, documents, key-value, full-text search, and vector search.
+
+- [**Graph Visualizer**](../../graphs/graph-visualizer.md):
+  A web-based tool for exploring your graph data with an intuitive interface and
+  sophisticated querying capabilities.
+
+- [**Graph Analytics**](../../graphs/graph-analytics.md):
+  A service that can efficiently load graph data from the core database system
+  and run graph algorithms such as PageRank and many more.
+
+- [**GenAI Suite**](../../data-science/_index.md):
+  ArangoDB's graph-powered machine learning (GraphML) as well as GraphRAG for
+  automatically building knowledge graphs from text and taking advantage of both
+  excerpts and higher-level summaries as context for turbocharging GenAI
+  applications.
+
+- [**Notebook servers**](../../data-science/notebook-servers.md):
+  Run Jupyter kernels in the Platform for hosting interactive, Python-based
+  notebooks to experiment and develop applications.
+
+- [**MLflow integration**](../../data-science/graphrag/services/mlflow.md):
+  Use the popular MLflow for machine learning practitioners as part of the
+  ArangoDB Platform.
diff --git a/site/content/3.13/components/platform.md b/site/content/3.13/components/platform.md
@@ -0,0 +1,219 @@
+---
+title: The ArangoDB Platform
+menuTitle: Platform
+weight: 169
+description: >-
+  The ArangoDB Platform brings everything ArangoDB offers together to a single
+  solution that you can deploy on-prem or use as a managed service
+---
+{{< tip >}}
+The ArangoDB Platform & GenAI Suite is available as a pre-release. To get
+exclusive early access, [get in touch](https://arangodb.com/contact/) with
+the ArangoDB team.
+{{< /tip >}}
+
+The ArangoDB Platform is a technical infrastructure that acts as the umbrella
+for hosting the entire ArangoDB offering of products. The Platform makes it easy
+to deploy and operate the core ArangoDB database system along with any additional
+ArangoDB products for machine learning, data explorations, and more. You can
+run it on-premises or in the cloud yourself on top of Kubernetes to access all
+of the platform features.
+
+## Features of the ArangoDB Platform
+
+- **Core database system**: The ArangoDB graph database system for storing
+  interconnected data.{{< comment >}} You can use the free Community Edition or the commercial
+  Enterprise Edition.{{< /comment >}}
+- **Graph Visualizer**: A web-based tool for exploring your graph data with an
+  intuitive interface and sophisticated querying capabilities.
+- **Graph Analytics**: A suite of graph algorithms including PageRank,
+  community detection, and centrality measures with support for GPU
+  acceleration thanks to Nvidia cuGraph.
+- **GenAI Suite**: A set of machine learning services, APIs, and
+  user interfaces that are available as a package as well as individual products.
+  - **GraphML**: A turnkey solution for graph machine learning for prediction
+    use cases such as fraud detection, supply chain, healthcare, retail, and
+    cyber security.
+  - **GraphRAG**: Leverage ArangoDB's graph, document, key-value,
+      full-text search, and vector search features to streamline knowledge
+      extraction and retrieval.
+      {{< comment >}}TODO: Not available in prerelease version
+      - **Txt2AQL**: Unlock natural language querying with a service that converts
+        user input into ArangoDB Query Language (AQL), powered by fine-tuned
+        private or public LLMs.
+      {{< /comment >}}
+      - **GraphRAG Importer**: Extract entities and relationships from large
+        text-based files, converting unstructured data into a knowledge graph
+        stored in ArangoDB.
+      - **GraphRAG Retriever**: Perform semantic similarity searches or aggregate
+        insights from graph communities with global and local queries.
+      - **MLflow integration**: Use the popular MLflow for machine learning
+        practitioners as part of the ArangoDB Platform.
+- **Jupyter notebooks**: Run a Jupyter kernel in the platform for hosting
+  interactive notebooks for experimentation and development of applications
+  that use ArangoDB as their backend.
+{{< comment >}}TODO: Mostly unrelated to Platform, vector index in core, 
+- **Vector embeddings**: You can train machine learning models for later use
+  in vector search in conjunction with the core database system's `vector`
+  index type. It allows you to find similar items in your dataset.
+{{< /comment >}}
+
+## Get started with the ArangoDB Platform
+
+### Use the ArangoDB Platform as a managed service
+
+The ArangoDB Platform is not available as a managed service yet, but it will
+become available for the [ArangoGraph Insights Platform](../arangograph/_index.md)
+in the future. Until then, you can request early access to the self-hosted
+ArangoDB Platform for testing.
+
+### Self-host the ArangoDB Platform
+
+You can set up and run the ArangoDB Platform on-premises or in the cloud and
+manage this deployment yourself.
+
+#### Requirements for self-hosting
+
+- **Early access to the ArangoDB Platform**:
+  [Get in touch](https://arangodb.com/contact/) with the ArangoDB team to get
+  exclusive early access to the pre-release of the ArangoDB Platform & GenAI Suite.
+
+- **Kubernetes**: Orchestrates the selected services that comprise the
+  ArangoDB Platform, running them in containers for safety and scalability.
+
+  Set up a [Kubernetes](https://kubernetes.io/) cluster if you don't have one
+  available yet.
+
+- **kubectl**: A command line tool for communicating with a Kubernetes cluster's
+  control plane.
+
+  Install [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl) for applying
+  specifications such as for creating the ArangoDB Core deployment, as well as
+  for checking pods, logs, etc.
+
+- **Helm**: A package manager for Kubernetes.
+
+  You need to have [helm](https://helm.sh/docs/intro/install/) installed in order
+  to install the required certificate manager and the ArangoDB Kubernetes Operator
+  as part of the Platform setup.
+
+- **Container registry**: A repository for storing and accessing container images.
+
+  You need to have a container registry for installing the images of the Platform
+  services. It can be a local registry.
+
+{{< comment >}}
+- **Licenses**: If you want to use any paid features, you need to purchase the
+  respective packages.
+{{< /comment >}}
+
+#### Setup
+
+1. Obtain a zip package of the ArangoDB Platform for the offline installation.
+   It includes helm charts, manifests, and blobs of the container image layers.
+   You also receive a package configuration file from the ArangoDB team.
+
+2. Install the certificate manager. You can check <https://github.com/cert-manager/cert-manager>
+   for the available releases.
+
+   ```sh
+   VERSION_CERT='1.18.2' # Use a newer version if available
+   helm repo add jetstack https://charts.jetstack.io
+   helm repo update
+
+   helm upgrade --install cert-manager \
+     --namespace cert-manager --create-namespace \
+     --version "v${VERSION_CERT}" \
+     jetstack/cert-manager \
+     --set crds.enabled=true
+   ```
+
+3. Install the ArangoDB operator for Kubernetes `kube-arangodb` with helm,
+   with options to enable webhooks, certificates, and the gateway feature.
+
+   ```sh
+   VERSION_OPERATOR='1.2.50' # Use a newer version if available
+
+   helm upgrade --install operator \
+     --namespace arangodb --create-namespace \
+     "https://github.com/arangodb/kube-arangodb/releases/download/${VERSION_OPERATOR}/kube-arangodb-${VERSION_OPERATOR}.tgz" \
+     --set "webhooks.enabled=true" \
+     --set "certificate.enabled=true" \
+     --set "operator.args[0]=--deployment.feature.gateway=true" \
+     --set "operator.architectures={amd64}" # or {arm64} for ARM-based CPUs
+   ```
+
+4. Create an `ArangoDeployment` specification for the ArangoDB Core. See the
+   [ArangoDeployment Custom Resource Overview](https://arangodb.github.io/kube-arangodb/docs/deployment-resource-reference.html)
+   and the linked reference.
+
+   You need to enable the gateway feature by setting `spec.gateway.enabled` and
+   `spec.gateway.dynamic` to `true` in the specification:
+
+    ```yaml
+    apiVersion: "database.arangodb.com/v1"
+    kind: "ArangoDeployment"
+    metadata:
+      name: "platform-example"
+    spec:
+      gateway:
+        enabled: true
+        dynamic: true
+      # ...
+    ```
+
+5. Download the ArangoDB Platform CLI tool `arangodb_operator_platform` from
+   <https://github.com/arangodb/kube-arangodb/releases>.
+   It is available for Linux and macOS, for the x86-64 as well as 64-bit ARM
+   architecture (e.g. `arangodb_operator_platform_linux_amd64`).
+
+   It is recommended to rename the downloaded executable to
+   `arangodb_operator_platform` and add it to the `PATH` environment variable
+   to make it available as a command in the system.
+
+   The Platform CLI tool simplifies the further setup and later management of
+   the Platform's Kubernetes services.
+
+6. Import the zip package of the ArangoDB Platform into the container registry.
+   Replace `platform.zip` with the file path of the offline installation package.
+   Replace `gcr.io/my-reg` with the address of your registry.
+
+   ```sh
+   arangodb_operator_platform package import \
+     --registry-docker-credentials \
+     gcr.io/my-reg \
+     ./platform.zip \
+     platform.imported.yaml
+   ```
+
+7. Install the package using the package configuration you received from the
+   ArangoDB team (`platform.yaml`) and the configuration generated by the
+   previous command (`platform.imported.yaml`). These configurations are merged,
+   allowing for targeted upgrades and user-defined overrides.
+
+   The package installation creates and enables various services, including
+   the unified web interface of the Platform.
+
+   ```sh
+   arangodb_operator_platform --context arangodb package install \
+     --platform.name platform-example \
+     ./platform.yaml \
+     ./platform.imported.yaml
+   ```
+
+## Interfaces
+
+The ArangoDB Platform uses a gateway to make all its services available via a
+single port at the external address of the deployment. For a local deployment,
+the base URL is `https://127.0.0.1:8529`.
+
+### Unified web interface
+
+You can access the ArangoDB Platform web interface with a browser by appending
+`/ui/` to the base URL, e.g. `https://127.0.0.1:8529/ui/`.
+
+### ArangoDB Core
+
+The HTTP API of the ArangoDB Core database system is available at the base URL.
+For example, the URL of the Cursor API for submitting AQL queries (against the `_system` database) is
+`https://127.0.0.1:8529/_db/_system/_api/cursor`.
diff --git a/site/content/3.13/components/tools/arangodb-shell/details.md b/site/content/3.13/components/tools/arangodb-shell/details.md
@@ -26,8 +26,8 @@ use the load command:
 require("internal").load("/tmp/test.js")
 ```
 
-You can exit arangosh using the key combination `<CTRL> + D` or by
-typing `quit<ENTER>`.
+You can exit arangosh using the key combination {{< kbd "Ctrl D" >}} or by
+typing `quit` and hitting {{< kbd "Return" >}}.
 
 ## Shell Output
 

diff --git a/site/content/3.13/components/tools/arangodb-shell/examples.md b/site/content/3.13/components/tools/arangodb-shell/examples.md
@@ -81,5 +81,5 @@ Calling it displays helpful information.
 
 _arangosh_ also provides auto-completion. Additional information on available 
 commands and methods is thus provided by typing the first few letters of a
-variable and then pressing the tab key. It is recommend to try this with entering
-`db.` (without pressing return) and then pressing tab.
+variable and then pressing the {{< kbd "Tab" >}} key. It is recommend to try this with entering
+`db.` (without pressing {{< kbd "Return" >}}) and then pressing {{< kbd "Tab" >}}.
diff --git a/site/content/3.13/components/web-interface/queries.md b/site/content/3.13/components/web-interface/queries.md
@@ -84,18 +84,18 @@ in the toolbar or via shortcut (see below).
 
 ### AQL Editor Shortcuts
 
-| Key combination | Action |
-|:----------------|:-------|
-| `Ctrl`/`Cmd` + `Return` | Execute query
-| `Ctrl`/`Cmd` + `Alt` + `Return` | Execute selected query
-| `Ctrl`/`Cmd` + `Shift` + `Return` | Explain query
-| `Ctrl`/`Cmd` + `Shift` + `S` | Save query
-| `Ctrl`/`Cmd` + `Shift` + `C` | Toggle comments
-| `Ctrl`/`Cmd` + `Z` | Undo last change
-| `Ctrl`/`Cmd` + `Shift` + `Z` | Redo last change
-| `Shift` + `Alt` + `Up` | Increase font size
-| `Shift` + `Alt` + `Down` | Decrease font size
-| `Ctrl` + `Space` | Open up the spotlight search
+| Key combination (regular)       | (Apple / macOS)                | Action
+|:--------------------------------|:-------------------------------|:-------------
+| {{< kbd "Ctrl Return" >}}       | {{< kbd "Cmd Return" >}}       | Execute query
+| {{< kbd "Ctrl Alt Return" >}}   | {{< kbd "Cmd Alt Return" >}}   | Execute selected query
+| {{< kbd "Ctrl Shift Return" >}} | {{< kbd "Cmd Shift Return" >}} | Explain query
+| {{< kbd "Ctrl Shift S" >}}      | {{< kbd "Cmd Shift S" >}}      | Save query
+| {{< kbd "Ctrl Shift C" >}}      | {{< kbd "Cmd Shift C" >}}      | Toggle comments
+| {{< kbd "Ctrl Z" >}}            | {{< kbd "Cmd Z" >}}            | Undo last change
+| {{< kbd "Ctrl Shift Z" >}}      | {{< kbd "Cmd Shift Z" >}}      | Redo last change
+| {{< kbd "Shift Alt Up" >}}      | {{< kbd "Shift Alt Up" >}}     | Increase font size
+| {{< kbd "Shift Alt Down" >}}    | {{< kbd "Shift Alt Down" >}}   | Decrease font size
+| {{< kbd "Ctrl Space" >}}        | {{< kbd "Ctrl Space" >}}       | Open up the spotlight search
 
 ## Running Queries