From 687daf0705eef5de958121c075790171f67e9bc4 Mon Sep 17 00:00:00 2001
From: Xe Iaso <me@xeiaso.net>
Date: Fri, 7 Nov 2025 19:12:33 -0500
Subject: [PATCH] docs: add OCI registry caveat docs

Signed-off-by: Xe Iaso <me@xeiaso.net>
---
 docs/docs/admin/roles/_category_.json  |  8 ++++++++
 docs/docs/admin/roles/oci-registry.mdx | 10 ++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 docs/docs/admin/roles/_category_.json
 create mode 100644 docs/docs/admin/roles/oci-registry.mdx

diff --git a/docs/docs/admin/roles/_category_.json b/docs/docs/admin/roles/_category_.json
new file mode 100644
index 00000000..2d5af0b3
--- /dev/null
+++ b/docs/docs/admin/roles/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Server Roles",
+  "position": 40,
+  "link": {
+    "type": "generated-index",
+    "description": "Various server roles you will need to keep in mind with Anubis."
+  }
+}
\ No newline at end of file
diff --git a/docs/docs/admin/roles/oci-registry.mdx b/docs/docs/admin/roles/oci-registry.mdx
new file mode 100644
index 00000000..56e64abc
--- /dev/null
+++ b/docs/docs/admin/roles/oci-registry.mdx
@@ -0,0 +1,10 @@
+# OCI Registries
+
+If you are serving an OCI registry behind Anubis, you will need to import the `(data)/clients/docker-client.yaml` file in order to make sure that OCI registry clients can download images:
+
+```yaml
+bots:
+  - import: (data)/meta/default-config.yaml
+  - import: (data)/clients/docker-client.yaml
+# ... the rest of your config
+```