Insomnia logo
  • Documentation
  • Get Started for Free
    • Introduction to Insomnia
    • Install Insomnia
    • Send Your First Request
    • Import and Export Data
    • Environment Variables
    • Global Environments
    • Insomnia Accounts
    • Forgotten Passphrase
    • Managing E2EE (End-to-End Encryption)
    • Organizations
    • Enable Enterprise membership
    • Configuring EE SSO
    • Integrating Insomnia Enterprise with Okta SAML 2.0
    • Integrating Insomnia Enterprise with Okta OpenID Connect
    • Integrating Insomnia Enterprise with Microsoft Azure/Entra ID SAML 2.0
    • Insomnia Whitelisting Guide for Enterprise Users
    • Transfer enterprise organizations and license
    • Configuring SCIM
    • Multiple Owners
    • Manage Domains
    • Invite Controls
    • Storage Controls
    • Session Report
    • Insomnia Subscriptions
    • Insomnia Subscription Management
    • Scratch Pad Tutorial
    • Requests
    • Responses
    • Request Collections
    • Request Timeouts
    • Chaining Requests
    • Post CSV Data
    • SOAP Requests
    • gRPC
    • WebSocket Support
    • Get Started with Documents
    • Design Documents
    • Linting
    • GraphQL for OpenAPI
    • Migrate from Designer
    • Unit Testing
    • Stress Testing
    • Insomnia Storage Options Guide
    • Sync with Insomnia Cloud
    • Sync with Git
    • Key Security Features
    • Security Standards
    • Signup and Authentication
    • Analytics Collected
    • End to End Data Encryption
    • Software Bill of Materials
    • Verifying Build Provenance for Signed Insomnia Binaries
    • Authentication
    • Client Certificates
    • Collection Runner
    • Generate Code Snippet
    • Cookie Management
    • Encoding
    • GraphQL Queries
    • Run in Insomnia Button
    • Key Maps
    • Proxy
    • Folder-level settings
    • Introduction to Plugins
    • Context Object Reference
    • Template Tags
    • Hooks and Actions
    • Custom Themes
    • AI Runner
    • FAQ
    • Application Data
    • SSL Validation
    • Password Recovery
    • Introduction to Inso CLI
    • Install Inso CLI
    • CLI Command Reference
      • inso run test
      • inso run collection
      • inso lint spec
      • inso export spec
      • inso script
      • Using Custom Linting with Inso CLI
    • Configuration
    • Inso CLI on Docker
    • Software Bill of Materials
    • Verifying Signatures for Signed Inso CLI Images
    • Verifying Inso CLI Build Provenance
      • Verifying Build Provenance for Signed Inso CLI Images
      • Verifying Build Provenance for Signed Inso CLI Binaries
    • Continuous Integration
    • Insomnia Pre-request Script Overview
    • Insomnia After-Response Script Overview
    • Secret Environment Variables
    • External Vault Integration (Enterprise feature)
    • Insomnia API Mocking Overview
    • Enterprise Login Report

FAQ

Here are the answers to the most frequently asked questions that we receive. For community support, see our support page.

General Questions


The following are general questions we frequently get about Insomnia.

What platforms does Insomnia run on?

Insomnia has desktop apps for 64-bit versions of Mac, Windows, and Linux.

Does Insomnia provide 32-bit binaries?

At this time, Insomnia is 64-bit only.

What software license does Insomnia use?

The Insomnia desktop application and related software packages are open source software under the Apache License 2.0 and the source code is available at github.com/kong/insomnia. The server-side software that backs the paid sync service is closed source.

Can I use Insomnia for commercial use?

Yes, of course! See our pricing page for plan information.

How can I support Insomnia?

First of all, thank you! Insomnia is currently building momentum, and the best thing you can do is help spread the word! You can also submit bug reports, request features, or contribute all through our open source repository, let us know how you use Insomnia using our documentation, or sign up for a paid plan.

Does Insomnia have a EULA agreement?

Currently there is no EULA that is provided for Insomnia. As of now we only have our Terms of Service and Privacy Policy.

Currently we consider the Apache License 2.0 license as a EULA but we are looking to change this in the future.

What is the team size limit for a free trial?

The free trial is limited to 5 team members. Once the trial has expired you will be billed for each team member, which means the post-trial limit is the number of member seats you purchase. Learn more about our pricing.

How do I increase the number of seats on my team?

To add more people to your team, the team owner needs to first update the subscription to include more seats. This can be simply accomplished by going to the Insomnia dashboard, located at https://app.insomnia.rest, then select Account -> Change Subscription, and then increase the Team Size as needed. You will be billed accordingly on your next statement.

How can I customize receipt data?

Add any information, such as company name, address, or VAT number, when creating or updating a subscription. Any changes to this information will appear on any invoices downloaded from the Invoice History page.

Note: Invoice data will only appear on downloaded invoices, not invoices received by email.

Why do I have multiple charges on my plan?

If you notice multiple charges for your Insomnia plan, it’s because some banks may display charge attempts as multiple entries when the currency differs. Our payment provider, Stripe, will only attempt to charge your designated payment method once. If you have additional questions, reach us through our support page.

Technical Questions


These technical questions commonly come up when user interact with Insomnia.

My app is not responding. What should I do?

Sometimes, if you make a request that returns a lot of data, Insomnia will become unresponsive. If this happens, manually delete the large response file by doing the following.

  1. Locate the Application Data Folder

    You can find the application data folder in the Help menu. If the help menu is not accessible, here are the default paths for each operating system.

    %APPDATA% on Windows $XDG_CONFIG_HOME or ~/.config on Linux ~/Library/Application\ Support on macOS

  2. Delete the Offending Response Body

    Each response stores the body inside its own file in the “responses” folder. Locate the large responses and delete them, then restart Insomnia.

    It’s safe to delete responses. Insomnia will simply report that it cannot locate the body.

How do I delete a large offending request body?

Some users have experienced the Insomnia app crashing after pasting in a large JSON request body. Here’s how to delete the offending request body while preserving the rest of your data:

  1. Quit Insomnia and back up (duplicate and rename) your Insomnia app data directory. See Application Data to locate the app data directory on your OS.

  2. Once you’ve backed up your app data, find the insomnia.requests.db file.

  3. Open insomnia.requests.db in your code editor.

  4. Each line in the file represents one request. Locate the offending body property in the request that made the app crash.

  5. Clear the body content in the JSON. As a precaution, search the rest of the file for the ID property that corresponds with the request that made the app crash. If the ID appears on any other request, clear the body property in those places too.

  6. Save and close the file. Open Insomnia, which should now work as expected.

How can I temporarily disable Nunjucks template?

You can disable templating of the request body via the request settings dialog (accessed from the sidebar). For more control, you can also disable templating by wrapping the desired content in the Nunjucks {% raw %} Tag.

Why don’t I see anything after importing a backup?

The import/export feature acts similarly to copying files in a filesystem. If the import contains data that originated from your application, data will be overwritten. However, if the import contains data that did not originate from your application, new data (including Request Collections and Design Documents) may have be created.

Note: Check for newly created Collections and Documents on the Dashboard.

Where does the application store data?

Insomnia stores data in Electron’s appData directory, which differs depending on platform. The local database is distributed across files with the name insomnia.${resourceName}.db.

  • %APPDATA%\Insomnia on Windows
  • XDG_CONFIG_HOME/Insomnia or ~/.config/Insomnia on Linux
  • ~/Library/Application\ Support/Insomnia on macOS

The app data directory can also be shown by navigating to Help > Show App Data Folder.

Where does the application store logs?

Insomnia stores logs in the following location, depending on the platform:

  • %APPDATA%\Insomnia\logs on Windows
  • $XDG_CONFIG_HOME/Insomnia/logs or ~/.config/Insomnia/logs on Linux
  • ~/Library/Logs/Insomnia on macOS

Open the parent folder by navigating to Help > Show App Logs Folder in Insomnia.

Where do I find keyboard shortcuts?

A list of all keyboard shortcuts can be found within the application under Preferences > Keyboard.

Where does Insomnia store environment information on a Linux (snap) install?

Various forms of user data, log files and environment information — the kind of data that’s generated and consumed by applications during operations can be located in the /var/snap/ directory. Additionally, the ~/snap directory that exists in a user’s home directory will contain directories using some of the names seen in /var/snap. These directories are meant to store versioned data related to settings used by your user account.

I’m having issues with a third-party plugin

Insomnia cannot make guarantees around the usability, maintenance, and security of third-party plugins. If you’re having issues with a plugin built and maintained by the Insomnia team, reach out to our community.

Edit this page
Report an issue
    COMPANY
  • Insomnia
  • Blog
  • Changelog
  • Pricing
  • Careers
    PRODUCTS
  • Insomnia
  • Inso (CLI)
    RESOURCES
  • Sign In
  • Documentation
  • Support
    LEGAL
  • Privacy Policy
  • Terms & Conditions
© Kong Inc. 2021