Nextcloud, NetBox and n8n integrations

Three read-only integrations, each with a monitoring page, alerts, maintenance
silencing and held-when-unreadable handling.

Nextcloud: database needing upgrade (critical), maintenance mode, and the data
disk running low; users, files and app updates with an admin app password.
NetBox: no background worker running, counts, and a list of the servers this
app manages that have no address in NetBox (a list, not an alert).
n8n: an active workflow whose last run failed, clearing when it next succeeds.

Disk messages for Immich, Paperless and Nextcloud now use the same units as
the pages that show them.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
bobbanandClaude Sonnet 5.5 committed 2026-10-24 23:13:13 +02:00
1 parent a16996d975
commit 4ff0b44943
46 files changed
+10137 -10

No files matched your search

+6
View File
@@ -16,6 +16,9 @@ import Authentik from "./pages/Authentik";
import Prometheus from "./pages/Prometheus";
import Immich from "./pages/Immich";
import Paperless from "./pages/Paperless";
import N8n from "./pages/N8n";
import NetBox from "./pages/NetBox";
import Nextcloud from "./pages/Nextcloud";
import ServiceLevels from "./pages/ServiceLevels";
import Duplicati from "./pages/Duplicati";
import MyWorkPage from "./pages/MyWork";
@@ -168,6 +171,9 @@ function Shelled({ user }: { user: CurrentUser }) {
<Route path="/prometheus" element={<Prometheus />} />
<Route path="/immich" element={<Immich />} />
<Route path="/paperless" element={<Paperless />} />
<Route path="/n8n" element={<N8n />} />
<Route path="/netbox" element={<NetBox />} />
<Route path="/nextcloud" element={<Nextcloud />} />
<Route path="/service-levels" element={<ServiceLevels user={user} />} />
<Route path="/duplicati" element={<Duplicati user={user} />} />
<Route path="/ports" element={<Ports user={user} />} />
+73 -1
View File
@@ -1228,6 +1228,69 @@ export interface JellyfinInfo {
problems: { key: string; message: string; severity: "warning" | "critical" }[];
}
/** One Nextcloud, as its page shows it. */
export interface NextcloudInfo {
id: number;
name: string;
enabled: boolean;
status: { at: string; ok: boolean; error: string | null } | null;
fresh: boolean;
state: {
version: string | null;
maintenance: boolean;
needsUpgrade: boolean;
/** Whether the monitoring app answered (an administrator's app password is needed). */
detail: boolean;
freeBytes: number | null;
users: number | null;
files: number | null;
active24h: number | null;
appUpdates: number | null;
updatedAt: string;
} | null;
problems: { key: string; message: string; severity: "warning" | "critical" }[];
}
/** One NetBox, as its page shows it. */
export interface NetBoxInfo {
id: number;
name: string;
enabled: boolean;
status: { at: string; ok: boolean; error: string | null } | null;
fresh: boolean;
state: {
version: string | null;
/** Null when NetBox did not say. */
workersRunning: number | null;
devices: number | null;
virtualMachines: number | null;
prefixes: number | null;
ipAddresses: number | null;
/** The servers this app manages that have no address in NetBox; null when NetBox's addresses could not be listed. */
missing: { id: number; name: string; ips: string[] }[] | null;
/** NetBox has more addresses than were read, so what is missing may be among the rest. */
truncated: boolean;
updatedAt: string;
} | null;
problems: { key: string; message: string; severity: "warning" | "critical" }[];
}
/** One n8n, as its page shows it. */
export interface N8nInfo {
id: number;
name: string;
enabled: boolean;
status: { at: string; ok: boolean; error: string | null } | null;
fresh: boolean;
state: {
workflows: { id: string; name: string; active: boolean; lastStatus: string | null; lastAt: string | null; failed24h: number }[];
/** False when the runs could not be asked: the last outcomes are then unknown. */
executionsKnown: boolean;
updatedAt: string;
} | null;
problems: { key: string; message: string; severity: "warning" | "critical" }[];
}
/** One Paperless-ngx, as its page shows it. */
export interface PaperlessInfo {
id: number;
@@ -2243,7 +2306,7 @@ export interface ManualTaskInput {
enabled?: boolean;
}
export type IntegrationType = "proxmox" | "synology" | "semaphore" | "tailscale" | "gitea" | "dockhand" | "uptimekuma" | "phpipam" | "pbs" | "osticket" | "unifi" | "npm" | "homeassistant" | "ups" | "jellyfin" | "authentik" | "prometheus" | "immich" | "paperless";
export type IntegrationType = "proxmox" | "synology" | "semaphore" | "tailscale" | "gitea" | "dockhand" | "uptimekuma" | "phpipam" | "pbs" | "osticket" | "unifi" | "npm" | "homeassistant" | "ups" | "jellyfin" | "authentik" | "prometheus" | "immich" | "paperless" | "nextcloud" | "netbox" | "n8n";
export interface IntegrationField {
key: string;
@@ -2790,6 +2853,15 @@ export const api = {
update: (id: number, data: ServiceLevelInput) => request<{ ok: boolean }>(`/api/service-levels/${id}`, { method: "PUT", body: JSON.stringify(data) }),
remove: (id: number) => request<void>(`/api/service-levels/${id}`, { method: "DELETE" }),
},
nextcloud: {
list: () => request<{ nextclouds: NextcloudInfo[] }>("/api/nextcloud"),
},
netbox: {
list: () => request<{ netboxes: NetBoxInfo[] }>("/api/netbox"),
},
n8n: {
list: () => request<{ n8ns: N8nInfo[] }>("/api/n8n"),
},
paperless: {
list: () => request<{ paperlesses: PaperlessInfo[] }>("/api/paperless"),
},
+3
View File
@@ -52,6 +52,9 @@ const INTEGRATION_TYPE_LABELS: Record<IntegrationType, string> = {
prometheus: "Prometheus",
immich: "Immich",
paperless: "Paperless-ngx",
n8n: "n8n",
netbox: "NetBox",
nextcloud: "Nextcloud",
};
const DNS_PROVIDER_LABELS: Record<DnsProviderType, string> = {
@@ -23,6 +23,9 @@ const TYPE_LABELS: Record<IntegrationType, string> = {
prometheus: "Prometheus",
immich: "Immich",
paperless: "Paperless-ngx",
n8n: "n8n",
netbox: "NetBox",
nextcloud: "Nextcloud",
};
export default function IntegrationEditForm({
+3
View File
@@ -22,6 +22,9 @@ const TYPE_LABELS: Record<IntegrationType, string> = {
prometheus: "Prometheus",
immich: "Immich",
paperless: "Paperless-ngx",
n8n: "n8n",
netbox: "NetBox",
nextcloud: "Nextcloud",
};
export default function IntegrationForm({ onCreated, onCancel }: { onCreated: () => void; onCancel: () => void }) {
+3
View File
@@ -24,6 +24,9 @@ const TYPE_LABELS: Record<string, string> = {
prometheus: "Prometheus",
immich: "Immich",
paperless: "Paperless-ngx",
n8n: "n8n",
netbox: "NetBox",
nextcloud: "Nextcloud",
};
export type WallLevel = "critical" | "warning" | "ok" | "unsure";
+6
View File
@@ -17,6 +17,9 @@ import {
IconPlugConnected,
IconBrandDocker,
IconAffiliate,
IconCloud,
IconBinaryTree,
IconBolt,
IconFileText,
IconFlame,
IconLock,
@@ -131,6 +134,9 @@ export const NAV: NavEntry[] = [
{ to: "/prometheus", label: "Prometheus", icon: <IconFlame size={20} /> },
{ to: "/immich", label: "Immich", icon: <IconPhoto size={20} /> },
{ to: "/paperless", label: "Paperless", icon: <IconFileText size={20} /> },
{ to: "/n8n", label: "n8n", icon: <IconBolt size={20} /> },
{ to: "/netbox", label: "NetBox", icon: <IconBinaryTree size={20} /> },
{ to: "/nextcloud", label: "Nextcloud", icon: <IconCloud size={20} /> },
{ to: "/service-levels", label: "Service levels", icon: <IconTargetArrow size={20} /> },
],
},
+6
View File
@@ -34,6 +34,9 @@ const TYPE_LABELS: Record<IntegrationType, string> = {
prometheus: "Prometheus",
immich: "Immich",
paperless: "Paperless-ngx",
n8n: "n8n",
netbox: "NetBox",
nextcloud: "Nextcloud",
};
/** The page each kind of integration gets once it is connected. */
@@ -57,6 +60,9 @@ const TYPE_PAGES: Record<IntegrationType, string> = {
prometheus: "/prometheus",
immich: "/immich",
paperless: "/paperless",
n8n: "/n8n",
netbox: "/netbox",
nextcloud: "/nextcloud",
};
/** "pve.example.lan" out of "https://pve.example.lan:8006/", or the text itself when it isn't an address. */
+126
View File
@@ -0,0 +1,126 @@
import { useEffect, useState } from "react";
import { Link } from "react-router-dom";
import { api, type N8nInfo } from "../api/client";
import EmptyState from "../components/EmptyState";
import TimeAgo from "../components/TimeAgo";
import { BlockSkeleton } from "../components/Skeleton";
import { ErrorNotice } from "../components/Notice";
import { readableError } from "../utils/errors";
function Badge({ n }: { n: N8nInfo }) {
if (!n.enabled) return <span className="badge bg-secondary-lt text-secondary">Off</span>;
if (!n.state) return <span className="badge bg-secondary-lt text-secondary">Not read yet</span>;
if (!n.fresh) return <span className="badge bg-yellow-lt text-yellow">Can&rsquo;t be read</span>;
if (n.problems.length > 0) return <span className="badge bg-yellow-lt text-yellow">Needs a look</span>;
return <span className="badge bg-green-lt text-green">In order</span>;
}
const failed = (status: string | null) => status === "error" || status === "crashed";
function LastRun({ status, at }: { status: string | null; at: string | null }) {
if (!status || !at) return <span className="text-secondary">no run seen</span>;
return (
<>
<span className={`badge ${failed(status) ? "bg-red-lt text-red" : status === "success" ? "bg-green-lt text-green" : "bg-secondary-lt text-secondary"}`}>{failed(status) ? (status === "crashed" ? "Crashed" : "Failed") : status === "success" ? "Succeeded" : status}</span>{" "}
<span className="text-secondary">
<TimeAgo value={at} />
</span>
</>
);
}
function Card({ n }: { n: N8nInfo }) {
const s = n.state;
const workflows = s ? [...s.workflows].sort((a, b) => Number(failed(b.lastStatus) && b.active) - Number(failed(a.lastStatus) && a.active) || Number(b.active) - Number(a.active) || a.name.localeCompare(b.name)) : [];
return (
<div className="card mb-3">
<div className="card-header">
<h3 className="card-title">
{n.name} <Badge n={n} />
</h3>
<div className="card-actions text-secondary small">{n.status ? <>read <TimeAgo value={n.status.at} /></> : "not read yet"}</div>
</div>
<div className="card-body">
{n.status && !n.status.ok && <div className="text-yellow mb-2">The last attempt to read it failed: {n.status.error ?? "no answer"}.</div>}
{n.problems.length > 0 && (
<ul className="mb-3">
{n.problems.map((x) => (
<li key={x.key}>{x.message}</li>
))}
</ul>
)}
{s && (
<>
{!s.executionsKnown && <div className="text-yellow mb-2">n8n did not give its runs, so what each workflow last did is not known.</div>}
<div className="text-secondary small mb-2">
{s.workflows.length} workflow{s.workflows.length === 1 ? "" : "s"}, {s.workflows.filter((w) => w.active).length} switched on — judged from the newest 250 runs
</div>
{workflows.length === 0 ? (
<div className="text-secondary">No workflows.</div>
) : (
<div className="table-responsive">
<table className="table table-vcenter table-sm">
<thead>
<tr>
<th>Workflow</th>
<th>On</th>
<th>Last run</th>
<th className="text-end">Failed in the last day</th>
</tr>
</thead>
<tbody>
{workflows.map((w) => (
<tr key={w.id} className={w.active ? "" : "text-secondary"}>
<td>{w.name}</td>
<td>{w.active ? "yes" : "off"}</td>
<td>{s.executionsKnown ? <LastRun status={w.lastStatus} at={w.lastAt} /> : "—"}</td>
<td className={`text-end ${w.failed24h > 0 ? "text-red fw-bold" : ""}`}>{w.failed24h}</td>
</tr>
))}
</tbody>
</table>
</div>
)}
</>
)}
</div>
</div>
);
}
/** n8n: which automations have quietly stopped working — an active workflow whose last run failed. */
export default function N8n() {
const [data, setData] = useState<N8nInfo[] | null>(null);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
const load = () =>
api.n8n
.list()
.then((r) => {
setData(r.n8ns);
setError(null);
})
.catch((err) => setError(readableError(err)));
void load();
const t = setInterval(load, 60_000);
return () => clearInterval(t);
}, []);
return (
<>
<h2 className="page-title">n8n</h2>
<p className="text-secondary">
Which automations have quietly stopped working. It is read every few minutes with an API key (see <Link to="/integrations">Integrations</Link>). A <strong>workflow that is switched on and failed on its last run</strong> is an alert — see <Link to="/alerts">Alerts</Link>; it clears when the workflow next succeeds.
</p>
<ErrorNotice error={error} />
{!data && !error && <BlockSkeleton lines={4} />}
{data && data.length === 0 && (
<div className="card">
<div className="card-body">
<EmptyState title="No n8n connected" hint="Add one under Integrations with its address and an API key (Settings → n8n API)." />
</div>
</div>
)}
{data?.map((n) => <Card key={n.id} n={n} />)}
</>
);
}
+123
View File
@@ -0,0 +1,123 @@
import { useEffect, useState } from "react";
import { Link } from "react-router-dom";
import { api, type NetBoxInfo } from "../api/client";
import EmptyState from "../components/EmptyState";
import TimeAgo from "../components/TimeAgo";
import { BlockSkeleton } from "../components/Skeleton";
import { ErrorNotice } from "../components/Notice";
import { readableError } from "../utils/errors";
function Badge({ n }: { n: NetBoxInfo }) {
if (!n.enabled) return <span className="badge bg-secondary-lt text-secondary">Off</span>;
if (!n.state) return <span className="badge bg-secondary-lt text-secondary">Not read yet</span>;
if (!n.fresh) return <span className="badge bg-yellow-lt text-yellow">Can&rsquo;t be read</span>;
if (n.problems.length > 0) return <span className="badge bg-yellow-lt text-yellow">Needs a look</span>;
return <span className="badge bg-green-lt text-green">In order</span>;
}
const count = (v: number | null) => (v === null ? "—" : v.toLocaleString());
function Tile({ label, value, bad }: { label: string; value: string; bad?: boolean }) {
return (
<div className="col-6 col-lg-3">
<div className="card card-sm h-100">
<div className="card-body">
<div className="text-secondary small">{label}</div>
<div className={`h2 mb-0 ${bad ? "text-red" : ""}`}>{value}</div>
</div>
</div>
</div>
);
}
function Card({ n }: { n: NetBoxInfo }) {
const s = n.state;
return (
<div className="card mb-3">
<div className="card-header">
<h3 className="card-title">
{n.name} <Badge n={n} />
</h3>
<div className="card-actions text-secondary small">{n.status ? <>read <TimeAgo value={n.status.at} /></> : "not read yet"}</div>
</div>
<div className="card-body">
{n.status && !n.status.ok && <div className="text-yellow mb-2">The last attempt to read it failed: {n.status.error ?? "no answer"}.</div>}
{n.problems.length > 0 && (
<ul className="mb-3">
{n.problems.map((x) => (
<li key={x.key}>{x.message}</li>
))}
</ul>
)}
{s && (
<>
<div className="text-secondary small mb-3">{s.version ? `version ${s.version}` : ""}</div>
<div className="row g-3 mb-3">
<Tile label="Workers running" value={count(s.workersRunning)} bad={s.workersRunning === 0} />
<Tile label="Devices" value={count(s.devices)} />
<Tile label="Virtual machines" value={count(s.virtualMachines)} />
<Tile label="IP addresses" value={count(s.ipAddresses)} />
</div>
<h4>Servers with no address in NetBox</h4>
{s.missing === null ? (
<div className="text-secondary">NetBox&rsquo;s addresses could not be listed, so nothing can be said about what is missing.</div>
) : s.missing.length === 0 ? (
<div className="text-secondary">Every server this app manages has an address in NetBox.</div>
) : (
<>
<ul className="mb-2">
{s.missing.map((m) => (
<li key={m.id}>
<Link to={`/servers/${m.id}`}>{m.name}</Link> <span className="text-secondary">({m.ips.slice(0, 3).join(", ")}{m.ips.length > 3 ? ", …" : ""})</span>
</li>
))}
</ul>
<div className="text-secondary small">
A list, not an alert: documentation that is behind is not an outage.{s.truncated ? " NetBox has more addresses than were read, so some of these may be in the part that was not." : ""}
</div>
</>
)}
</>
)}
</div>
</div>
);
}
/** NetBox: whether it is working — above all its background workers — and which of the servers you run are not written down in it. */
export default function NetBox() {
const [data, setData] = useState<NetBoxInfo[] | null>(null);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
const load = () =>
api.netbox
.list()
.then((r) => {
setData(r.netboxes);
setError(null);
})
.catch((err) => setError(readableError(err)));
void load();
const t = setInterval(load, 60_000);
return () => clearInterval(t);
}, []);
return (
<>
<h2 className="page-title">NetBox</h2>
<p className="text-secondary">
Whether NetBox is working, and whether it is complete. It is read every few minutes with an API token (see <Link to="/integrations">Integrations</Link>). <strong>No background worker running</strong> is an alert — see <Link to="/alerts">Alerts</Link>; the servers missing from NetBox are only listed.
</p>
<ErrorNotice error={error} />
{!data && !error && <BlockSkeleton lines={4} />}
{data && data.length === 0 && (
<div className="card">
<div className="card-body">
<EmptyState title="No NetBox connected" hint="Add one under Integrations with its address and an API token (your profile → API Tokens; read-only is enough)." />
</div>
</div>
)}
{data?.map((n) => <Card key={n.id} n={n} />)}
</>
);
}
+131
View File
@@ -0,0 +1,131 @@
import { useEffect, useState } from "react";
import { Link } from "react-router-dom";
import { api, type NextcloudInfo } from "../api/client";
import EmptyState from "../components/EmptyState";
import TimeAgo from "../components/TimeAgo";
import { BlockSkeleton } from "../components/Skeleton";
import { ErrorNotice } from "../components/Notice";
import { formatBytes } from "./settings/StorageSettings";
import { readableError } from "../utils/errors";
function Badge({ n }: { n: NextcloudInfo }) {
if (!n.enabled) return <span className="badge bg-secondary-lt text-secondary">Off</span>;
if (!n.state) return <span className="badge bg-secondary-lt text-secondary">Not read yet</span>;
if (!n.fresh) return <span className="badge bg-yellow-lt text-yellow">Can&rsquo;t be read</span>;
if (n.problems.some((x) => x.severity === "critical")) return <span className="badge bg-red-lt text-red">Needs a look</span>;
if (n.problems.length > 0) return <span className="badge bg-yellow-lt text-yellow">Needs a look</span>;
return <span className="badge bg-green-lt text-green">In order</span>;
}
const count = (v: number | null) => (v === null ? "—" : v.toLocaleString());
function Card({ n }: { n: NextcloudInfo }) {
const s = n.state;
return (
<div className="card mb-3">
<div className="card-header">
<h3 className="card-title">
{n.name} <Badge n={n} />
</h3>
<div className="card-actions text-secondary small">{n.status ? <>read <TimeAgo value={n.status.at} /></> : "not read yet"}</div>
</div>
<div className="card-body">
{n.status && !n.status.ok && <div className="text-yellow mb-2">The last attempt to read it failed: {n.status.error ?? "no answer"}.</div>}
{n.problems.length > 0 && (
<ul className="mb-3">
{n.problems.map((x) => (
<li key={x.key} className={x.severity === "critical" ? "text-red" : ""}>
{x.message}
</li>
))}
</ul>
)}
{s && (
<>
<div className="text-secondary small mb-3">
{[s.version ? `version ${s.version}` : null, s.maintenance ? "in maintenance mode" : null, s.needsUpgrade ? "needs its database upgrading" : null].filter(Boolean).join(" · ")}
</div>
{s.detail ? (
<div className="row g-3">
<div className="col-6 col-lg-3">
<div className="card card-sm h-100">
<div className="card-body">
<div className="text-secondary small">Free for data</div>
<div className="h2 mb-0">{s.freeBytes === null ? "—" : formatBytes(s.freeBytes)}</div>
</div>
</div>
</div>
<div className="col-6 col-lg-3">
<div className="card card-sm h-100">
<div className="card-body">
<div className="text-secondary small">Users</div>
<div className="h2 mb-0">{count(s.users)}</div>
<div className="text-secondary small">{s.active24h === null ? "" : `${s.active24h} active in the last day`}</div>
</div>
</div>
</div>
<div className="col-6 col-lg-3">
<div className="card card-sm h-100">
<div className="card-body">
<div className="text-secondary small">Files</div>
<div className="h2 mb-0">{count(s.files)}</div>
</div>
</div>
</div>
<div className="col-6 col-lg-3">
<div className="card card-sm h-100">
<div className="card-body">
<div className="text-secondary small">App updates waiting</div>
<div className="h2 mb-0">{count(s.appUpdates)}</div>
</div>
</div>
</div>
</div>
) : (
<div className="text-secondary">
Only its status is read. Give the integration an administrator&rsquo;s name and an <strong>app password</strong> (Personal settings → Security → Devices &amp; sessions) and the room left for the data, the users and the app updates are read too.
</div>
)}
</>
)}
</div>
</div>
);
}
/** Nextcloud: whether people can sign in — maintenance mode, a database that wants upgrading — and how much room is left for the data. */
export default function Nextcloud() {
const [data, setData] = useState<NextcloudInfo[] | null>(null);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
const load = () =>
api.nextcloud
.list()
.then((r) => {
setData(r.nextclouds);
setError(null);
})
.catch((err) => setError(readableError(err)));
void load();
const t = setInterval(load, 60_000);
return () => clearInterval(t);
}, []);
return (
<>
<h2 className="page-title">Nextcloud</h2>
<p className="text-secondary">
Whether people can sign in. It is read every few minutes (see <Link to="/integrations">Integrations</Link>). <strong>Maintenance mode left on</strong>, <strong>a database that wants upgrading</strong> and <strong>the data disk running low</strong> are alerts — see <Link to="/alerts">Alerts</Link>.
</p>
<ErrorNotice error={error} />
{!data && !error && <BlockSkeleton lines={4} />}
{data && data.length === 0 && (
<div className="card">
<div className="card-body">
<EmptyState title="No Nextcloud connected" hint="Add one under Integrations with its address; an administrator's name and an app password add the disk, the users and the app updates." />
</div>
</div>
)}
{data?.map((n) => <Card key={n.id} n={n} />)}
</>
);
}
+3
View File
@@ -32,6 +32,9 @@ const INTEGRATION_NAMES: Record<string, string> = {
prometheus: "Prometheus",
immich: "Immich",
paperless: "Paperless-ngx",
n8n: "n8n",
netbox: "NetBox",
nextcloud: "Nextcloud",
};
function ColorList({