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

Migrate from Designer

Note: The migrate instructions on this page only apply to Insomnia versions 2021.7.2 and older. If you’re on a newer version than 2021.7.2, you won’t have the migrate option within the app. However, you can still migrate your data. See Migration Alternatives.

With the release of 2021.1.0, Insomnia Designer and Insomnia Core were merged into a single application, Insomnia. Insomnia Designer has been deprecated, and will no longer receive updates. To allow for a smooth transition for Designer users to Insomnia v2021.1, we’ve created an automated migration workflow.

Migrate

If you’re an Insomnia Designer user, you’ll be presented with a data migration flow asking you what data you would like to migrate. If the migration is successful, you’ll be notified and prompted to restart the application.

The migration modal shows different migration options to copy workspaces, plugins, and designer application settings. The migration modal shows different migration options to copy workspaces, plugins, and designer application settings.

Note: If you decide to skip the migration, you can always re-open the data migration flow via Preferences > General > Migrate from Designer.

Backup

When migration begins, a backup of your data will be created at /insomnia/core-backup.

app-data-dir is stored in the following location:

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

In the current state, each time you migrate, this backup is overwritten just prior to starting migration.

Restore from backup

If there is an unexpected error during migration, you will be shown the error that occurred. The data directory will be restored from backup, and you will be prompted to restart the application.

Manual restore

You may also choose to manually restore from the backup directory created at <app-data-dir>/insomnia/core-backup. In the current state, each time you migrate, this backup is overwritten just prior to starting migration.

See Backup for a list of app-data-dir locations based on your OS.

The <app-data-dir>/insomnia/core-backup directory contains the following data:

  • insomnia.{model}.db database files
  • plugins folder
  • responses folder
  • version-control folder

Each of these items also exists in the parent folder, <app-data-dir>/insomnia, which contains the current data used by the application.

In order to manually restore, do the following:

  1. Close Insomnia
  2. Delete the plugins, responses, and version-control folders in the <app-data-dir>/insomnia live data directory
  3. Copy-paste everything from <app-data-dir>/insomnia/core-backup into <app-data-dir>/insomnia, overwriting everything that exists
  4. Launch Insomnia

Edge case

If you moved your workspace from Core to Designer several months ago, and are now merging the same workspace (with the same id) from Designer back into Core, this edge case applies. The merge won’t remove any children of the workspace (such as requests, request groups, certificates), but if a duplicate id is found, it will favor the data coming from Designer.

In the unlikely scenario that you can’t see your requests or workspace in Insomnia after migration, restore your data from your backup. Alternatively, because the migration is primarily additive and will not remove anything from the existing database (it will overwrite if the same id is found), some entries may become orphaned. Find orphaned entries by opening the insomnia.{model}.db files.

Migration Alternatives

You can still migrate your data in the following situations:

  • You’ve never installed Insomnia but have Insomnia Designer
  • You have Insomnia 2021.7.3 or newer installed already

Warning: Insomnia Designer and Insomnia use different data directories. When attempting to migrate from Insomnia Designer, backup both the Insomnia and Insomnia Designer data directories. Backups are especially important when you have to (temporarily) downgrade Insomnia from a previously installed newer version.

  1. Install Insomnia 2021.7.2 via GitHub releases.
  2. You’ll be prompted to migrate from Designer in a pop-up modal. Follow the instructions. Alternatively, if you missed the modal or delayed the migration, access the migration option through Preferences > General. Find the Migrate from Designer section and click the Show migration flow button.
  3. After you’ve completed the migration, upgrade Insomnia through Preferences in the section Software Updates.
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