--- title: Insomnia description: Introduction to Insomnia, the open source desktop application that simplifies designing, debugging, and testing APIs. url: "/insomnia/" canonical_url: "/insomnia/" content_type: landing_page products: - Insomnia tags: - design-apis - test-apis canonical: true --- # Insomnia Simplify designing, debugging, and testing APIs with Insomnia Insomnia is an open source desktop application that simplifies designing, debugging, and testing APIs. Insomnia combines an easy-to-use interface with advanced functionality, like authentication helpers, code generation, and environment variables. You can install Insomnia on macOS, Windows, and Ubuntu. ![Image of the Insomnia UI](/assets/images/insomnia/entry-page.png) ## Install Insomnia ### macOS Download and install Insomnia for macOS. [Download](https://updates.insomnia.rest/downloads/mac/latest?app=com.insomnia.app&source=website) ### Windows Download and install Insomnia for Windows. [Download](https://updates.insomnia.rest/downloads/windows/latest?app=com.insomnia.app&source=website) ### Linux Download and install Insomnia for Linux. [Download](https://updates.insomnia.rest/downloads/ubuntu/latest?&app=com.insomnia.app&source=website) ## Get started ### Documents Build and iterate on your OpenAPI specs to design your next API. [Learn more](/insomnia/documents/) ### Collections Use collections to call APIs and run automated tests. [Learn more](/insomnia/collections/) ### MCP Clients Use MCP clients to connect Insomnia to Konnect for mocking, validating, and protecting requests in real time. [Learn more](/insomnia/mcp-clients-in-insomnia/) ### Mock servers Use mock servers to simulate API endpoints when building features. [Learn more](/insomnia/mock-servers/) ### Environments Use environments to reuse values across requests and collections. [Learn more](/insomnia/environments/) ### Inso CLI Include Inso CLI in your CI/CD pipelines to automate Insomnia tasks. [Learn more](/inso-cli/) ### Koh CLI Let AI agents like Claude Code work with your Insomnia collections, requests, and specs. [Learn more](/koh/) ## Account management ### Insomnia Enterprise Learn about the features available with the Enterprise plan. [Learn more](/insomnia/enterprise/) ### Manage Insomnia Learn how to manage your Insomnia account and security. [Learn more](/insomnia/manage-insomnia/) ### Plugins Extend Insomnia with powerful plugins. [Learn more](/insomnia/plugins/) ## Storage ### Local vault Store your Insomnia data locally on your device. [Learn more](/insomnia/storage/#local-vault) ### Cloud sync Store your Insomnia data securely in the cloud. [Learn more](/insomnia/storage/#cloud-sync) ### Git sync Store your Insomnia data on a Git repository. [Learn more](/insomnia/git-sync/) ## Security ### RBAC Use Role-based access control (RBAC) for fine-grain control over who can access which Insomnia resources. [Learn more](/insomnia/rbac/) ### SSO Set up Single Sign-On (SSO) to allow your users to log in using your preferred Identity Provider. [Learn more](/insomnia/sso/) ### SCIM Set up System for Cross-domain Identity Management (SCIM) provisioning to manage users and teams from your Identity Provider. [Learn more](/insomnia/scim/) ## Capabilities ### [Local storage](/insomnia/storage/#local-vault) Essentials: Supported Pro: Supported Enterprise: Supported ### [API testing](/insomnia/test/) Essentials: Supported Pro: Supported Enterprise: Supported ### [Cloud-hosted mock server](/insomnia/mock-servers/) Essentials: Supported Pro: Supported Enterprise: Supported ### [Automated API testing](/inso-cli/) Essentials: Supported Pro: Supported Enterprise: Supported ### [Test Konnect Gateway Service and Routes](/insomnia/konnect-integration/) Essentials: Not Supported Pro: Not Supported Enterprise: Supported ### [End-to-End Encryption](/insomnia/data-security/#end-to-end-encryption) Essentials: Supported Pro: Supported Enterprise: Supported ### [Cloud Sync](/insomnia/storage/#cloud-sync) Essentials: Supported Pro: Supported Enterprise: Supported ### [Git Sync](/insomnia/storage/#git-sync) Essentials: Supported Pro: Supported Enterprise: Supported ### [Enterprise SSO (SAML, OIDC)](/insomnia/sso/) Essentials: Not Supported Pro: Not Supported Enterprise: Supported ### [Enterprise support](/insomnia/enterprise/) Essentials: Not Supported Pro: Not Supported Enterprise: Supported For more details about Enterprise capabilities, see [Insomnia Enterprise](/insomnia/enterprise/). See the full feature comparison on our [pricing page](https://insomnia.rest/pricing). ## How-to guides * [Add custom linting rules in Insomnia](/how-to/add-custom-linting-rules/) * [Automate tests in Insomnia](/how-to/automate-tests/) * [Configure Azure SAML SSO in Insomnia](/how-to/azure-saml-sso-insomnia/) * [Chain requests in Insomnia](/how-to/chain-requests/) * [Configure third-party Git credentials for Git Sync in Insomnia](/how-to/configure-third-party-git-credentials-git-sync/) ## References & tools * [Keyboard shortcuts for Insomnia](/insomnia/Keyboard-shortcuts/) * [Accounts](/insomnia/accounts/) * [Insomnia proxy and allowlist](/insomnia/allowlist/) * [API specs in Insomnia](/insomnia/api-specs/) * [Collected data](/insomnia/collected-data/) ## Frequently asked questions - Where can I find the Insomnia changelog? Insomnia release notes are published at [https://insomnia.rest/changelog](https://insomnia.rest/changelog). - How often does Insomnia release updates? Insomnia releases a major version update twice a year, publishes minor updates every four weeks, and issues patches as needed. Insomnia beta builds are available roughly one week before each release. Learn [how Insomnia ships software](/insomnia/release-policy/), or view the latest versions, betas, and changelogs in the [Insomnia changelog](https://insomnia.rest/changelog). - Does Insomnia automatically update to the latest version? On macOS and Windows, Insomnia can update automatically. To enable automatic updates in Insomnia, go to **Preferences > General > Software Updates > Automatically download and install updates** and check the checkbox. On Linux, update behavior depends on how you install Insomnia. For example, some installation methods like Flatpak or if your Linux system manages the app, then the app can't update itself. Because Insomnia doesn't own or maintain all Linux distribution mechanisms, automatic updates aren't guaranteed on Linux.