Skip to main content

N8n

@sntxrr/n8nv2026.09.05.1· 5d agoMODELS
01README

Read a running n8n deployment and report how far its pinned version has drifted behind the channel n8n itself calls stable. Both methods are strictly read-only — this extension never upgrades n8n, edits a workflow, touches a credential, or restarts a container; it tells you an update exists and stops there. drift takes the running version as an argument rather than reading it, because n8n does not disclose one: its /rest/settings answers 200 unauthenticated but with settingsMode: public, a reduced payload carrying no version field at all, and versionCli reaches authenticated callers only — so the version comes from the pinned image tag on the host, which is what the deployment actually is rather than what a process predating the current pin believes itself to be. The upgrade target is npm's dist-tag, never the newest published release: n8n ships its in-progress minor into the same GitHub release namespace flagged prerelease: true and promotes that line later, so on 2026-09-05 the newest release was 2.38.3 while stable was 2.37.10, and the 2.37 line had itself been prerelease through 2.37.6. GitHub releases are still read, but only to enumerate the stable releases that were missed and to link the notes, since the prerelease flag is the historical record of which line was stable when and dist-tags do not retain it. Image existence is verified against registry-1.docker.io rather than the docker.n8n.io mirror the pin names: that mirror 404s its own token endpoint, delegates auth to Docker Hub, and then answers 429 to every manifest request for tags that exist and tags that do not alike, so it cannot return a usable answer — and a 429 is raised as indeterminate rather than folded into absent, which would suppress every update forever while the check looked healthy. An exhausted GitHub rate limit, an unreachable registry, and an unparseable running version are all raised as errors rather than reported as a reassuring current.

02Models1
@sntxrr/n8n/instancev2026.09.05.1n8n_instance.ts

Global Arguments

ArgumentTypeDescription
baseUrlstringBase URL of the n8n instance, e.g. http://192.0.2.10:5678. Used only
npmPackagestringnpm package whose dist-tags define the release channels. Override only
channelstringWhich npm dist-tag is authoritative for what should be running.
githubRepostringGitHub `owner/repo` used to enumerate missed releases and link notes.
githubToken?stringOptional GitHub token, purely to raise the API rate limit. Needs no
imageRepositorystringFully qualified image the deployment actually pulls. Reported in
verifyRegistrystringRegistry host that existence is actually checked against. Must answer
verifyRepositorystringRepository path within `verifyRegistry`, serving the same images as
timeoutMsnumberAbort each HTTP call after this long. A drift check must never hang a
fn sync()
Probe the instance's /healthz and its pre-login /rest/settings, recording liveness and the auth surface. Unauthenticated and read-only.
fn drift(runningVersion: string, pageSize: number, verifyImage: boolean)
Compare a running n8n version against the npm channel n8n treats as stable, enumerate the stable releases in between, and confirm the target image is actually pullable.
ArgumentTypeDescription
runningVersionstringVersion currently deployed, e.g. 2.25.7. Read this from the pinned
pageSizenumberHow many recent releases to examine when enumerating what was
verifyImagebooleanConfirm the target tag resolves in the registry before reporting

Resources

instance(infinite)— What the instance discloses before login: liveness and the auth surface. Deliberately not the version -- n8n does not disclose one unauthenticated.
drift(infinite)— Comparison of the running version against the authoritative npm channel.
03Stats
A
100 / 100
Downloads
2
Archive size
23.4 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
04Platforms
05Labels