API

The API layer, developed with Node, serves as the front door to Nango, handling requests from customer applications. It processes operations related to integrations, connections, actions, and syncs, offering a unified interface for developers.

Control plane store

This Control plane store, running on Postgres, handles configuration data for users, integrations, connections, and integration scripts.

Jobs queue

The Jobs queue, running on Postgres, manages the scheduling of script executions (along with the Orchestrator Node service). It’s responsible for orchestrating the timing and execution of data synchronization tasks, ensuring that sync scripts run according to their schedules without loss or delay.

Jobs service

The Jobs Service dispatches jobs to runner services. It acts as the central manager that allocates integration script execution tasks to available runners, balancing load and ensuring efficient processing of integration logic.

Runner service

Runner services, running on Node, are isolated per customer and responsible for running the integration scripts. These services directly interact with external APIs, executing the custom logic defined in action, sync, and webhook scripts. When self-hosting Nango, there is only one runner.

Records store

This Records storage, running on Postgres, component persists the records by syncs being executed in the runners.

Script store

Integration scripts, whether provided by Nango as templates or developed by customers (step-by-step guide), are stored in blob storage (S3). This provides a scalable, secure storage solution that ensures integration scripts are readily accessible for execution by the runner services.

Logs store

Logs are critical to have observability over how your integration scripts are run. Nango automatically generates logs, but you can add custom logs in your integration scripts as well. Logs are surfaced and searchable in the Nango UI. The Logs store runs on ElasticSearch.

​

Self-hosting

Nango offers the flexibility to be self-hosted, appealing to enterprises with specific compliance or operational requirements. The infrastructure components, including the API, control plane, and all associated services, can be deployed within a customer’s own environment. The self-hosting option comes in two editions:

• Free Edition: Includes just the API and control plane, focuses on authorizing external APIs.
• Enterprise Self-Hosting Edition: Offers the full suite of Nango components, providing the complete capabilities of Nango in a self-hosted configuration.

​

Conclusion

Nango’s infrastructure is designed for scalability, reliability, and flexibility, supporting the full range of integration scenarios. From handling real-time actions to managing complex sync schedules, each component plays a crucial role in delivering a seamless integration experience. Whether utilized as a cloud service or deployed in a self-hosted environment, Nango provides the foundation for a robust and tailored API integration infrastructure.