mrkeyoor.com_
Mon 14 Sept 15:50 UTC
Self-Hostedevaluationupdated 14 Sept 2026

nango review

Nango is a platform for adding external API integrations to a product or AI agent. It manages user authorization, stores and refreshes credentials, proxies authenticated requests, and runs TypeScript functions for syncs, actions, webhooks, triggers, and MCP tools.

Verdict

Our Nango checkout pulled 2,187 packages and 1,848 MB, then its root tests failed in 8 seconds, so adopting the full source tree means accepting a large platform and investigating the test environment before changing it. Nango is a sensible shortlist choice for a product team that needs customer OAuth, proxy calls, syncs, actions, and MCP behind one control plane. Use Cloud for the lowest operating burden; choose self-hosting only after the Elastic License, paid feature boundary, key management, and multi-service footprint have been approved.

We ran it

Lab card: what happened when we ran nangoScreenshot of nango (nango.dev)
Install✓ · 61s2187 packages · 1848 MB
Buildn/ano build script
Tests✗ · 8sran, no count parsed
Known vulns190 critical · 0 high · 18 moderate · 1 low (npm audit)
Repo9553 files~348,820 lines of source · 287.4 MB · 20 CI workflows · Dockerfile · tests dir

Answers from our run

Does nango build from source?

Dependencies installed in 61 seconds (2187 packages), and the project has no separate build step. We cloned commit cc64d64 into a clean Debian container with 3 CPUs and no project-specific setup.

Do nango's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Does nango have known vulnerabilities in its dependencies?

npm audit flagged 19 known advisories in the dependency tree at the time of our run.

Who should not use nango?

Hobbyists expecting the free self-hosted edition to include the whole platform: its table excludes syncs, tool calls, webhooks, triggers, prebuilt tools, and the MCP server.

What are the alternatives to nango?

Pipedream, Airbyte, openid-client. Our Nango checkout pulled 2,187 packages and 1,848 MB, then its root tests failed in 8 seconds, so adopting the full source tree means accepting a large platform and investigating the test environment before changing it.

Setup2/51,848 MB install and failed root tests; production spans many services
Docs5/5Detailed auth, proxy, runtime, self-hosting, and security guides
Community5/512,020 stars, a September 14 push, and active pull requests
Maturity4/5Broad operations surface, with test and runner concerns to assess

Who it’s for

Product teams connecting customers to several of Nango's 900+ documented APIs.
SaaS builders who want an embedded OAuth flow plus a credential-aware API proxy.
Platform teams prepared to review generated TypeScript and operate integration functions.
Enterprise teams that need MCP, syncs, webhooks, audit controls, and self-hosting under a paid plan.

Who it’s NOT for

Hobbyists expecting the free self-hosted edition to include the whole platform: its table excludes syncs, tool calls, webhooks, triggers, prebuilt tools, and the MCP server.
Companies that need an OSI-approved license or want to sell Nango itself as a hosted service: Elastic License 2.0 bars offering a substantial set of its features as a managed service.
Small teams seeking one lightweight OAuth library: Enterprise self-hosting documents 5 Node services plus Postgres, Redis, object storage, and Elasticsearch.
Operators who require encryption-key rotation today: the self-hosting guide says changing NANGO_ENCRYPTION_KEY after setup causes decryption failures.
Buyers who need the root test command to pass in a clean checkout: our run failed in 8 seconds, and the supplied log tail does not show the originating exception.

Setup reality

Our sandbox installed 2,187 npm packages in 61 seconds and used 1,848 MB. No standard build script or target was detected, so build was skipped. Tests failed with exit 1 after 8 seconds. npm audit reported 19 known vulnerabilities: 18 moderate and 1 low.

The test tail says test:integration exited with code 1. The unit runner showed packages/billing/lib/clients/orb/adapters.unit.test.ts with 0 tests, then the CLI and unit processes received SIGTERM when the concurrent command stopped them. The tail does not identify the first exception, so it does not support a root-cause claim.

Development also needs the services started by the repository's Docker setup and a populated .env. Production self-hosting adds databases, queues, storage, encryption keys, public callback URLs, and provider credentials. Free self-hosting covers Auth and Proxy; Enterprise is required for the full runtime and MCP feature set.

Three primitives cover auth, proxy calls, and TypeScript functions

Nango organizes integration work around 3 pieces. Auth runs embedded authorization flows, stores credentials, and refreshes tokens. Proxy accepts an API request, finds the customer's connection, adds credentials, and handles retries and rate limits. Functions are TypeScript jobs for syncs, actions, webhooks, and triggers. The README lists more than 900 APIs for teams whose integration backlog has outgrown hand-built OAuth callbacks.

Developers can write a TypeScript function or ask the AI builder to generate one, then review and version the result before deployment. The runtime supplies API access, retries, storage, and logs, while the application calls it through SDKs, the HTTP API, or MCP. Teams still own schemas, provider quirks, idempotency, and the business rules around each external action.

Version 0.71.7 puts the full feature set behind paid deployment

The cloud quickstart starts with an account, an integration, one authorized connection, and a secret key. Free self-hosting has a much narrower table: API Auth and Proxy are included, with observability limited to those paths. Syncs, tool calls, webhooks, triggers, prebuilt integrations, MCP, branding controls, RBAC, and MFA sit in Nango Cloud or Enterprise self-hosting.

Nango can expose MCP tools that act on external APIs, and release v0.71.7 added a provider lookup plus agent-session and proxy-tool work. The management MCP server runs inside the main server but requires a dedicated hostname that differs from the public Nango hostname. This also expands the authentication and audit boundary around tools that can write to customer systems.

What happened when we ran it

Our sandbox installed 2,187 npm packages in 61 seconds and consumed 1,848 MB on disk. commit cc64d64 was a 287.4 MB checkout containing 9,553 files and roughly 348,820 lines of source. The monorepo used npm workspaces, had 20 CI workflow files, a Dockerfile, and a tests directory. Our harness found no standard build target, so it skipped the build step rather than claiming a compilation result.

The root test command failed with exit code 1 after 8 seconds. Its tail reports that test:integration exited first. The unit output then names a billing adapter file with 0 tests, while test:cli and test:unit received SIGTERM after the concurrent runner stopped the remaining processes. The captured tail ends around Node's CommonJS loader and does not contain the initiating exception. We can say the suite failed in our container; we cannot say why from this log.

The npm audit found 19 known vulnerabilities, consisting of 18 moderate findings and 1 low finding. There were no critical or high-severity findings in the supplied result. That is better than a dependency tree with urgent advisories, though 2,187 installed packages still create a wide update surface. The lab run did not start provider integrations, complete OAuth, execute a sync, or test the hosted service, so it measures repository setup rather than end-to-end product reliability.

Five Node services make Enterprise self-hosting an operations project

Nango's Enterprise guide lists 5 Node services: Server, Orchestrator, Jobs, Runner, and Persist. Its recommended baseline gives each 1 CPU and 2 GB of RAM, then adds Postgres, Redis, object storage, and Elasticsearch for execution data. Helm is the default deployment route, and managed images follow a 2-month release cadence with occasional hotfixes. This is a platform that needs ownership, monitoring, backups, and upgrade rehearsals.

The security setup deserves its own design review. A base64-encoded 256-bit key encrypts credentials and record data, and Connect UI also requires it. Key rotation is unsupported; changing the key later causes decryption failures. Production deployments should use external Postgres and Redis rather than the bundled local stores. The guide also documents outbound URL controls, internal service authentication, optional mTLS, dashboard access, and callback routing.

Elastic License 2.0 limits hosted-service use

The repository uses Elastic License 2.0. It permits use, modification, and distribution, while forbidding a third party from offering the software as a hosted or managed service that exposes a substantial set of its features. That is different from an OSI-approved permissive license. A SaaS embedding Nango to connect its own users may fit the intended use, but a company reselling the integration platform itself needs a legal review.

Issue 7412 reports a self-hosted runner retaining roughly 40 KB per task and exhausting the V8 heap around 10,000 tasks in the reporter's environment. Issue 7098 documents an OAuth 1 signature mismatch when an object query parameter contains a space. Both include detailed reproductions. They are reasons to test the exact provider mix and sustained task volume before a production cutover.

September 14 activity and 124 open items show a busy project

GitHub recorded 12,020 stars, 124 combined open issues and pull requests, and a last push on September 14, 2026. Release v0.71.7 arrived on September 11 with provider, webhook, audit, agent-session, billing, and security changes. Pull requests were still receiving review on September 14. The combined queue reflects both open work and a steady stream of contributions rather than 124 confirmed bugs.

Nango earns attention when integration infrastructure is already a product problem. The 900+ provider catalog, code-based functions, embedded auth, proxy, and MCP surface can replace several internal systems. Our failed 8-second root test and 1,848 MB install show that source-level ownership is expensive, while the free self-hosted limitations rule out many headline features. Trial the cloud path first unless data location or regulation requires Enterprise self-hosting, and test key recovery, provider failures, and runner endurance before migration.

Alternatives

ProjectWhat it isPick it when
PipedreamA hosted workflow and component platform centered on connecting APIs quickly.pick this instead when event workflows and a large component catalog matter more than owning an embedded auth and integration runtime.
Airbyte gh↗A data-movement platform for pulling from APIs, databases, and files into destinations.pick this instead when recurring ELT and connector breadth are the job, without embedded customer OAuth actions.
openid-clientA focused JavaScript client for OAuth 2 and OpenID Connect.pick this instead when you have a few standards-based providers and prefer to own token storage, refresh, and API calls.
n8n gh↗A visual and code-based workflow system with 400+ listed integrations.pick this instead when internal automation workflows matter more than an integration layer embedded in your product.

What people are saying

  1. [github-trending] NangoHQ/nango

Sources

  1. Nango repository and README
  2. Nango v0.71.7 release
  3. Nango self-hosting guide
  4. Nango Elastic License 2.0
  5. Issue 7412: runner memory retention
  6. Issue 7098: OAuth 1 space-signing mismatch

More self-hosted reviews

Mailspring · kvm · SmartTubeLegacy · danmu_api · tvbox · opendisplay · the whole board →