Tools: How to Migrate from Google Antigravity IDE 1.x to 2.x on Linux (With Sandbox & Shortcut Fixes) (2026)

Tools: How to Migrate from Google Antigravity IDE 1.x to 2.x on Linux (With Sandbox & Shortcut Fixes) (2026)

1. Back Up Your Data (Don't Skip!)

2. Install Antigravity IDE 2.x from .tar.gz

A. Extract and Move to /opt

B. Fix the Chrome Sandbox Permission Error

3. Remove Old 1.x Files

4. Fix Duplicate & Blank Taskbar Icons (Desktop Integration)

A. Create or Edit the Shortcut File

B. Paste this Optimized Configuration

C. Refresh Desktop Database Upgrading from Antigravity IDE 1.x to Antigravity 2.x is a major architectural transition. In the 2.x generation, the core environment has shifted to a robust, standalone, agentic workspace, while retaining a sibling editor package (Antigravity IDE) that houses all your familiar VS Code extensions, settings, and workflows. If you are a Linux user transitioning to 2.x using the .tar.gz archive, you might encounter common friction points such as Chromium sandbox errors or missing desktop integration/taskbar grouping. This guide walks you through the entire migration process and solves these issues once and for all. Before modifying anything, back up your existing settings, extensions, and chat history. Open your terminal and run: If you are installing the new version from a .tar.gz archive, here is the standard system integration workflow: Extract the archive and move the directory to /opt for system-wide access: When launching the IDE for the first time, you might see this common Electron/Chromium crash error: Fix this by setting the correct owner and SUID permission on the sandbox binary: Once you have verified that version 2.x is functioning, you can safely clean up your old 1.x installation files: If you launch the IDE and find that a new, iconless program window opens separately in your dock rather than grouping under your pinned shortcut, the system cannot match your .desktop file to the running application's window class name ( WM_CLASS ). To resolve this, update your desktop shortcut with the correct StartupWMClass. Create a new desktop entry in your local applications directory: Ensure the StartupWMClass is set exactly to antigravity-ide (all lowercase): Apply the changes instantly so the launcher updates your application menu: Final Step: Unpin any old icons from your dock or taskbar, restart the IDE from your applications menu, and pin the active window. It will now group cleanly under a single high-resolution icon! Templates let you quickly answer FAQs or store snippets for re-use. Hide child comments as well For further actions, you may consider blocking this person and/or reporting abuse

Code Block

Copy

cp -r ~/.gemini/antigravity ~/.gemini/antigravity-backup-manual cp -r ~/.gemini/antigravity ~/.gemini/antigravity-backup-manual cp -r ~/.gemini/antigravity ~/.gemini/antigravity-backup-manual tar -xvzf Antigravity-IDE.tar.gz sudo mv Antigravity-IDE /opt/antigravity-ide tar -xvzf Antigravity-IDE.tar.gz sudo mv Antigravity-IDE /opt/antigravity-ide tar -xvzf Antigravity-IDE.tar.gz sudo mv Antigravity-IDE /opt/antigravity-ide FATAL:setuid_sandbox_host.cc] The SUID sandbox helper binary was found, but is not configured correctly. ... You need to make sure that /opt/antigravity-ide/chrome-sandbox is owned by root and has mode 4755. FATAL:setuid_sandbox_host.cc] The SUID sandbox helper binary was found, but is not configured correctly. ... You need to make sure that /opt/antigravity-ide/chrome-sandbox is owned by root and has mode 4755. FATAL:setuid_sandbox_host.cc] The SUID sandbox helper binary was found, but is not configured correctly. ... You need to make sure that /opt/antigravity-ide/chrome-sandbox is owned by root and has mode 4755. sudo chown root:root /opt/antigravity-ide/chrome-sandbox sudo chmod 4755 /opt/antigravity-ide/chrome-sandbox sudo chown root:root /opt/antigravity-ide/chrome-sandbox sudo chmod 4755 /opt/antigravity-ide/chrome-sandbox sudo chown root:root /opt/antigravity-ide/chrome-sandbox sudo chmod 4755 /opt/antigravity-ide/chrome-sandbox sudo apt remove antigravity sudo rm -rf /path/to/antigravity-ide-old sudo apt remove antigravity sudo rm -rf /path/to/antigravity-ide-old sudo apt remove antigravity sudo rm -rf /path/to/antigravity-ide-old nano ~/.local/share/applications/antigravity.desktop nano ~/.local/share/applications/antigravity.desktop nano ~/.local/share/applications/antigravity.desktop [Desktop Entry] Name=Antigravity Comment=Experience liftoff GenericName=Text Editor Exec=/opt/antigravity-ide/antigravity-ide %F Icon=/opt/antigravity-ide/resources/app/resources/linux/code.png Type=Application StartupNotify=false StartupWMClass=antigravity-ide Categories=TextEditor;Development;IDE; MimeType=application/x-antigravity-workspace; Actions=new-empty-window; Keywords=vscode; [Desktop Action new-empty-window] Name=New Empty Window Exec=/opt/antigravity-ide/antigravity-ide --new-window %F Icon=/opt/antigravity-ide/resources/app/resources/linux/code.png [Desktop Entry] Name=Antigravity Comment=Experience liftoff GenericName=Text Editor Exec=/opt/antigravity-ide/antigravity-ide %F Icon=/opt/antigravity-ide/resources/app/resources/linux/code.png Type=Application StartupNotify=false StartupWMClass=antigravity-ide Categories=TextEditor;Development;IDE; MimeType=application/x-antigravity-workspace; Actions=new-empty-window; Keywords=vscode; [Desktop Action new-empty-window] Name=New Empty Window Exec=/opt/antigravity-ide/antigravity-ide --new-window %F Icon=/opt/antigravity-ide/resources/app/resources/linux/code.png [Desktop Entry] Name=Antigravity Comment=Experience liftoff GenericName=Text Editor Exec=/opt/antigravity-ide/antigravity-ide %F Icon=/opt/antigravity-ide/resources/app/resources/linux/code.png Type=Application StartupNotify=false StartupWMClass=antigravity-ide Categories=TextEditor;Development;IDE; MimeType=application/x-antigravity-workspace; Actions=new-empty-window; Keywords=vscode; [Desktop Action new-empty-window] Name=New Empty Window Exec=/opt/antigravity-ide/antigravity-ide --new-window %F Icon=/opt/antigravity-ide/resources/app/resources/linux/code.png update-desktop-database ~/.local/share/applications/ update-desktop-database ~/.local/share/applications/ update-desktop-database ~/.local/share/applications/