Astro Docs

Data transfer

How to migrate your Astro data from one computer to another

When you need to migrate your Astro data from one Mac to another, you can transfer the complete database file that contains all your keywords, rankings history, tags, and app data.

⚠️ WARNING: This procedure will replace all existing data on the destination computer. Make sure to backup your current data before proceeding.

What gets transferred

When you migrate the database file, you transfer:

  • All your apps and their keywords
  • Complete ranking history and data
  • All tags and their associations
  • App notes
  • Ratings

Migration Steps

Step 1: Locate the database file on your old Mac

  1. Open Finder
  2. Press Cmd + Shift + G to open “Go to Folder”
  3. Paste this path and press Enter: 
    /Users/yourusername/Library/Containers/matteospada.it.ASO/Data/Library/Application Support/Astro
    (Replace yourusername with your actual username)
  4. Look for the file named model.sqlite

Step 2: Copy the database file

  1. Copy the model.sqlite file to a USB drive, cloud storage, or transfer it via AirDrop to your new Mac

Step 3: Prepare the new Mac

  1. Install Astro on your new Mac if you haven’t already
  2. Run Astro at least once to create the necessary folder structure

Step 4: Replace the database file

  1. On your new Mac, open Finder
  2. Press Cmd + Shift + G and navigate to: 
    /Users/yourusername/Library/Containers/matteospada.it.ASO/Data/Library/Application Support/Astro
    (Replace yourusername with your new Mac’s username)
  3. Delete all existing files in this folder
  4. Copy your model.sqlite file from the old Mac into this folder

Step 5: Restart Astro

  1. Launch Astro on your new Mac
  2. All your data, including keywords, rankings history, and tags should now be available

Note: Don’t forget to transfer your license to your new Mac if you haven’t already done so.

Troubleshooting

If you encounter any issues:

  • Make sure Astro is completely closed before replacing files
  • Verify that the model.sqlite file was copied completely
  • Check that you have the correct permissions to access the Application Support folder
  • If problems persist, try running Astro once on the new Mac before transferring the file

Alternative: CSV Export/Import

For a partial data transfer (keywords only), you can use the Import/Export Keywords feature, though this method will not preserve ranking history and tags.


Still have questions? Write us an email.

Next
License transfer