Skip to main content

SquareX to Legba: A Step by Step Migration Guide

Step by step migration from SquareX to Legba. Remove the old extension if it is still pinned, install Legba, toggle Ghost Mode, and map every SquareX setting to its Legba equivalent. Includes troubleshooting for the most common snags.

Estimated reading time: 7 min read

If you are here because your SquareX extension went dark or because the public Chrome Web Store listing no longer works, this guide is the shortest path from there to a working replacement. Install Legba, toggle Ghost Mode, and verify isolation. If all you want is the three steps, scroll to the next section and stop reading when you are done.

If you want the setting-by-setting map, the troubleshooting for the usual snags, and the small amount of context that makes the migration feel less like a rushed switch and more like a planned upgrade, keep reading. The whole guide is designed to take five minutes.

The Three Step Migration

  1. 01

    Remove the SquareX extension (if it is still there)

    Click the puzzle-piece icon in the Chrome toolbar. Find SquareX in the list, click the three-dot menu, and pick Remove from Chrome. If SquareX is no longer in your extension list, Chrome has already cleaned up the old extension, and you can skip to step 02.

    SquareX is disposable by design, so there is no user data to export before uninstalling. That is actually the point of a disposable browser. Sessions were meant to be destroyed when you were done with them.

  2. 02

    Install Legba from the Chrome Web Store

    Open the Legba listing on the Chrome Web Store and click Add to Chrome. The install takes about twenty seconds on a normal connection. Chrome will ask you to confirm the requested permissions, which are the permissions needed to intercept and route browsing traffic through the isolation layer. Accept.

    The Legba icon will appear in the Chrome toolbar. If you want it permanently visible, pin it from the puzzle-piece menu. This is the same pinning flow you used for SquareX.

  3. 03

    Turn Ghost Mode on, verify, and you are done

    Click the Legba icon. Toggle Ghost Mode on. The toolbar icon state changes to active, which is Legba's visible indicator for isolation. Open a new tab, browse to any site you want to verify against, and the session is now running inside an isolated edge container. Close the tab, the session is destroyed.

    The mental model to carry over from SquareX is the tab is disposable. That remains true in Legba. Close it and it is gone.

Setting-by-Setting Map: SquareX to Legba

SquareX and Legba call similar things by different names. The table below maps what you used on the left to the equivalent Legba control on the right, with a short note about any gap.

SquareX settingLegba equivalentNote
New disposable sessionGhost Mode toggleIn Legba you flip Ghost Mode on from the extension popup. Every new tab opens inside an isolated edge session until you flip it off.
Close tab to destroy sessionClose tab to destroy sessionThe behavior is the same. Closing the tab destroys the isolated session and any cookies, cache, or storage inside it.
Cloud-rendered Chromium VMEdge-based isolated sessionThe isolation layer is different under the hood. You do not need to configure it. For a full architectural comparison, read the Legba vs SquareX write-up.
Disposable file viewerIsolated downloads inside the sessionFiles open and stay inside the ephemeral Legba session. If you explicitly save a download, it lands in your normal Downloads folder. If you do not save it, it disappears with the session.
Region pickerExit point selectorPick a country from the Legba popup. Legba supports 15+ exit countries built into the extension, no separate VPN required.
Block trackers and fingerprintingPer-session fingerprint isolationEvery Ghost Mode session presents a clean browser fingerprint, so cross-session tracking is frustrated by default.
SquareX Pro add-onsIncluded in the flat planLegba does not tier. The full product, MSP features excluded, is in the $10 a month plan. MSPs have a dedicated tier at /msp.

Two Things That Are Different

Most of the migration is one-to-one. Two differences are worth naming out loud, because they will come up inside your first week of using Legba and you will want to know what is happening.

1. Edge isolation feels like Chrome, not like streamed video.

SquareX streamed pixels from a cloud VM to your tab. Some users loved this because the isolation boundary was physical. Some users disliked it because fast scrolling and typing had a visible lag. Legba does not stream pixels. The isolation runs at the network edge close to you, and the rendering happens in your local Chrome. In day-to-day use, this feels like normal browsing. If you preferred the cloud-VM feel for strict isolation reasons, that architecture now lives inside Zscaler's enterprise stack.

2. There is no free tier. The $10 a month is the whole product.

If you were on SquareX Free, the jump to a paid product is a real friction. We do not soften it by tiering. Legba charges one flat price for the full product, so we do not have a shared free pool to starve paying users at peak. One flat $10 a month covers everything on the consumer plan.

Troubleshooting: The Common Snags

My SquareX icon is still there but greyed out.

A stale icon can remain pinned locally even after the public Web Store listing stops working. Right click the icon, pick Remove from Chrome, and the shell is gone. If the icon never changed state, check the Extensions page and remove SquareX there.

Ghost Mode is on but a site still looks like my regular browser.

Ghost Mode applies to new tabs created after you toggle it. Existing tabs are not retroactively isolated, because that would break the session you are currently logged into. Open a new tab and retry. If you need a site to run inside Legba, close the pre-isolation tab first.

I see my real geo location even with an exit point selected.

Check the popup and confirm the exit point is the one you expect. Some browser APIs cache a location hint independently of the routing layer. Restarting the tab after changing the exit point clears this in almost every case. WebRTC leaks, if you are worried about them, are handled by Legba's per-session browser profile.

I want to keep SquareX-style behavior where every tab is disposable.

In Legba, leave Ghost Mode on by default. Every new tab you open while Ghost Mode is on is a fresh isolated session, destroyed on close. If you prefer a per-tab toggle instead of a global toggle, let us know at support@legba.app and tell us how you were using SquareX. We do ship updates based on feedback from real migrations.

My IT team managed SquareX for us. How do I do that with Legba?

Legba has an MSP and team tier at /msp with multi-tenant management, per-client policy, bulk provisioning, and isolation analytics across every tenant. If you came from SquareX through an MSP, the MSP tier is the right entry point. Book a call through the MSP page and we will set up a tenant.

I have a question the guide did not cover.

Email support@legba.app with the subject line SquareX migration and a short description of your setup. Migration questions get triaged to the front of the queue, and we respond with specifics rather than a canned reply.

How to Verify You Are Actually Isolated

Trust, but verify. The easiest way to confirm Ghost Mode is doing what it says on the tin:

  1. Toggle Ghost Mode on from the Legba popup.
  2. Open a new tab and browse to an IP check site. The reported IP should match the exit point you selected, not your home or office IP.
  3. Close the tab, reopen a new one, and visit the same check. The session fingerprint should be different. Same exit point if you kept it, but different session identity. That is isolation doing its job.

If anything in that flow does not match what you see, send the specifics to support@legba.app. We respond to migration emails first.

You Are Done. Next Steps.

If the migration feels anticlimactic, that is because it is. Browser isolation extensions are supposed to be small. The whole pitch is that one toggle replaces a lot of fiddly security hygiene. Your SquareX toggle got removed. Your Legba toggle does the same job.

From here, the things worth reading are the full architectural comparison in Legba vs SquareX, the three-way post-acquisition comparison in SquareX vs Zscaler vs Legba, and the technical deep dive in How Legba's Browser-Native Isolation Actually Protects You. The SquareX alternatives page has the side-by-side feature map if you want one more reference.

Architecture comparison, the three-way against Zscaler, and the technical deep dive on Legba's isolation.

Your Migration, in Under Five Minutes

Install Legba from the Chrome Web Store and flip Ghost Mode on. Email support@legba.app with the subject line SquareX if you want help mapping any previous SquareX setting to its Legba equivalent.

About the authors.

Your agent needs its Legba.

Read the docs