feat: add proxmox integration

apps/nextjs/src/app/[locale]/manage/integrations/_components/secrets/integration-secret-icons.ts

@@ -1,4 +1,4 @@
-import { IconKey, IconPassword, IconUser } from "@tabler/icons-react";
+import { IconGrid3x3, IconKey, IconPassword, IconServer, IconUser } from "@tabler/icons-react";
 
 import type { IntegrationSecretKind } from "@homarr/definitions";
 import type { TablerIcon } from "@homarr/ui";
@@ -7,4 +7,6 @@ export const integrationSecretIcons = {
   username: IconUser,
   apiKey: IconKey,
   password: IconPassword,
+  realm: IconServer,
+  tokenId: IconGrid3x3
 } satisfies Record<IntegrationSecretKind, TablerIcon>;

packages/definitions/src/integration.ts

@@ -5,6 +5,8 @@ export const integrationSecretKindObject = {
   apiKey: { isPublic: false },
   username: { isPublic: true },
   password: { isPublic: false },
+  tokenId: { isPublic: true },
+  realm: { isPublic: true }
 } satisfies Record<string, { isPublic: boolean }>;
 
 export const integrationSecretKinds = objectKeys(integrationSecretKindObject);
@@ -137,6 +139,12 @@ export const integrationDefs = {
     category: ["mediaTranscoding"],
     iconUrl: "https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons@master/png/tdarr.png",
   },
+  proxmox: {
+    name: "Proxmox",
+    secretKinds: [['username', 'tokenId', 'apiKey', 'realm']],
+    category: ['healthMonitoring'],
+    iconUrl: "https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons@master/png/proxmox.png"
+  }
 } as const satisfies Record<string, integrationDefinition>;
 
 export const integrationKinds = objectKeys(integrationDefs) as AtLeastOneOf<IntegrationKind>;

packages/integrations/package.json

@@ -35,6 +35,7 @@
     "@homarr/translation": "workspace:^0.1.0",
     "@homarr/validation": "workspace:^0.1.0",
     "@jellyfin/sdk": "^0.11.0",
+    "proxmox-api": "^1.1.1",
     "xml2js": "^0.6.2"
   },
   "devDependencies": {

packages/integrations/src/base/creator.ts

@@ -24,6 +24,7 @@ import { PiHoleIntegration } from "../pi-hole/pi-hole-integration";
 import { PlexIntegration } from "../plex/plex-integration";
 import { ProwlarrIntegration } from "../prowlarr/prowlarr-integration";
 import type { Integration, IntegrationInput } from "./integration";
+import { ProxmoxIntegration } from "../proxmox/proxmox-integration";
 
 export const integrationCreator = <TKind extends keyof typeof integrationCreators>(
   integration: IntegrationInput & { kind: TKind },
@@ -72,4 +73,5 @@ export const integrationCreators = {
   readarr: ReadarrIntegration,
   dashDot: DashDotIntegration,
   tdarr: TdarrIntegration,
+  proxmox: ProxmoxIntegration
 } satisfies Record<IntegrationKind, new (integration: IntegrationInput) => Integration>;

packages/integrations/src/index.ts

@@ -18,6 +18,7 @@ export { PlexIntegration } from "./plex/plex-integration";
 export { ProwlarrIntegration } from "./prowlarr/prowlarr-integration";
 export { LidarrIntegration } from "./media-organizer/lidarr/lidarr-integration";
 export { ReadarrIntegration } from "./media-organizer/readarr/readarr-integration";
+export { ProxmoxIntegration } from "./proxmox/proxmox-integration";
 
 // Types
 export type { IntegrationInput } from "./base/integration";

packages/integrations/src/proxmox/proxmox-integration.ts

@@ -0,0 +1,69 @@
+import proxmoxApi from "proxmox-api";
+
+import { Integration } from "../base/integration";
+import type { HealthMonitoring } from "../interfaces/health-monitoring/healt-monitoring";
+
+export class ProxmoxIntegration extends Integration {
+  public async testConnectionAsync(): Promise<void> {
+    process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0"; // TODO: Can we improve this?
+    const proxmox = this.getPromoxApi();
+    await proxmox.nodes.$get();
+  }
+
+  public async getSystemInfoAsync(): Promise<HealthMonitoring> {
+    const proxmox = this.getPromoxApi();
+    const resources = await proxmox.cluster.resources.$get();
+
+    let resourceSummary: ResourceSummary = { vms: [], lxcs: [], nodes: [], storage: [] };
+    resources.forEach((item) => {
+      let resource: ResourceData = {
+        id: item.id,
+        cpu: item.cpu ? item.cpu : 0,
+        maxCpu: item.maxcpu ? item.maxcpu : 0,
+        maxMem: item.maxmem ? item.maxmem : 0,
+        mem: item.mem ? item.mem : 0,
+        name: item.name,
+        node: item.node,
+        status: item.status,
+        running: false,
+        type: item.type,
+        uptime: item.uptime,
+        vmId: item.vmid,
+        netIn: item.netin,
+        netOut: item.netout,
+        diskRead: item.diskread,
+        diskWrite: item.diskwrite,
+        disk: item.disk,
+        maxDisk: item.maxdisk,
+        haState: item.hastate,
+        storagePlugin: item.plugintype,
+        storageShared: item.shared == 1,
+      };
+      if (item.template == 0) {
+        if (item.type === "qemu") {
+          resource.running = resource.status === "running";
+          resourceSummary.vms.push(resource);
+        } else if (item.type === "lxc") {
+          resource.running = resource.status === "running";
+          resourceSummary.lxcs.push(resource);
+        }
+      } else if (item.type === "node") {
+        resource.name = item.node;
+        resource.running = resource.status === "online";
+        resourceSummary.nodes.push(resource);
+      } else if (item.type === "storage") {
+        resource.name = item.storage;
+        resource.running = resource.status === "available";
+        resourceSummary.storage.push(resource);
+      }
+    });
+  }
+
+  private getPromoxApi() {
+    return proxmoxApi({
+      host: this.url("/").host,
+      tokenID: `${this.getSecretValue("username")}@${this.getSecretValue("realm")}!${this.getSecretValue("tokenId")}`,
+      tokenSecret: this.getSecretValue("apiKey"),
+    });
+  }
+}

packages/translation/src/lang/en.json

@@ -718,6 +718,14 @@
         "password": {
           "label": "Password",
           "newLabel": "New password"
+        },
+        "tokenId": {
+          "label": "Token ID",
+          "newLabel": "New token ID"
+        },
+        "realm": {
+          "label": "Realm",
+          "newLabel": "New realm"
         }
       }
     },