From cdc574eda7f5e3893838dd23a40f695a3beb3c79 Mon Sep 17 00:00:00 2001
From: Manuel <30572287+manuel-rw@users.noreply.github.com>
Date: Thu, 7 Aug 2025 21:34:50 +0200
Subject: [PATCH] docs: add truenas integration

---
 docs/integrations/truenas/index.mdx | 36 +++++++++++++++++++++++++++++
 docs/integrations/truenas/index.ts  |  7 ++++++
 2 files changed, 43 insertions(+)
 create mode 100644 docs/integrations/truenas/index.mdx
 create mode 100644 docs/integrations/truenas/index.ts

diff --git a/docs/integrations/truenas/index.mdx b/docs/integrations/truenas/index.mdx
new file mode 100644
index 00000000..9dcd0032
--- /dev/null
+++ b/docs/integrations/truenas/index.mdx
@@ -0,0 +1,36 @@
+---
+title: 'TrueNAS'
+description: "Enterprise network-attached storage for your home, office, and cloud."
+hide_title: true
+---
+
+import { IntegrationHeader } from '@site/src/components/integrations/header';
+import { IntegrationCapabilites } from '@site/src/components/integrations/widgets';
+import { AddingIntegration } from '@site/src/components/integrations/adding';
+import { IntegrationSecrets } from '@site/src/components/integrations/secrets';
+import { truenasIntegration } from '.';
+import { systemResourcesWidget } from '@site/docs/widgets/system-resources';
+
+
+<IntegrationHeader
+  integration={truenasIntegration}
+  categories={['NAS', 'Hardware']}
+/>
+
+### Widgets & Capabilities
+<IntegrationCapabilites
+    items={[{ widget: systemResourcesWidget }]}
+/>
+
+### Adding the integration
+<AddingIntegration />
+
+### Secrets
+<IntegrationSecrets secrets={[{
+    credentials: ['username', 'password'],
+    steps: [
+      "Create a user on the TrueNAS UI with a secure password at \"Credentials\" > \"Users\" > \"Add User\".",
+      "Add the auxiliary group \"auxiliary_administrator\" to the user.",
+      "Save the user and create an integration in Homarr with the previous defined credentials"
+    ],
+}]} />
\ No newline at end of file
diff --git a/docs/integrations/truenas/index.ts b/docs/integrations/truenas/index.ts
new file mode 100644
index 00000000..01707cc5
--- /dev/null
+++ b/docs/integrations/truenas/index.ts
@@ -0,0 +1,7 @@
+import { IntegrationDefinition } from '@site/src/types';
+export const truenasIntegration: IntegrationDefinition = {
+  name: 'TrueNAS',
+  description: 'Enterprise network-attached storage for your home, office, and cloud.',
+  iconUrl: 'https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/truenas.svg',
+  path: '../../integrations/truenas',
+};