IPRoyal proxies in Mosaic: one line, an exit per profile

We make Mosaic, the local-first anti-detect browser; IPRoyal is a proxy seller you bring your own account to. This page is the setup, not a review of IPRoyal's network.

IPRoyal gives you one gateway line with your account's tokens in it. Mosaic reads IPRoyal's gateway line from the seller's own documentation, so the separator, the place tokens and the session shape are read off that line rather than retyped.

Connect IPRoyal to Mosaic

1. In IPRoyal's dashboard, copy the gateway line for the pool you want, with your username and password in it.
2. In Mosaic, open a profile's proxy field, or the Proxies screen, and paste the line. Mosaic detects it as IPRoyal and saves it as a provider you can reuse.
3. Create profiles from the provider. Each one mints its own IPRoyal session, so each profile browses from a different exit.
4. Press Start. Mosaic checks the proxy before every launch and will not open the browser until IPRoyal has answered and tunnelled, so a dead proxy never leaks your own address.

IPRoyal carries a session id Mosaic recognises, so each profile mints its own session and holds its own exit. An IPRoyal session that answers but reaches nothing is swapped for a fresh one rather than retried, because a residential session that is dead stays dead for every attempt on the same token.

How it works: Provider minting

What you can set per profile with IPRoyal

IPRoyal's line carries the exit country, a state or region, a city, a sticky session id and how long a session holds, so those are what Mosaic lets you choose per profile. Pick country, state and city in IPRoyal's own words, and the exit matches. A pick IPRoyal has no word for is refused by name, because a token a gateway silently ignores would put the profile somewhere else without telling you. The words Mosaic does not recognise still survive, because the line is copied rather than rebuilt, so an option IPRoyal added that Mosaic has never seen still reaches the exit.

What Mosaic does with the IPRoyal exit

Once an IPRoyal proxy is checked, Mosaic reads the public address and city it comes out at and matches the profile to it: the timezone, the languages and the geolocation are set from the exit, not from the proxy's label. Mosaic also stops WebRTC from going around the IPRoyal proxy, so a page cannot read your real address that way. The authentication runs through a local relay, so an IPRoyal login works over HTTP, HTTPS and SOCKS5, including SOCKS5 with a username and password, which Chrome cannot log in to on its own.

The honest limits

Mosaic does not sell proxies or proxy traffic; the IPRoyal bill is between you and IPRoyal. Mosaic reads IPRoyal's format from the published documentation and has not run it against a live IPRoyal account, so the row shows an untested badge; the format may be out of date if IPRoyal has changed it. Whether to run several accounts on IPRoyal exits is the platform's rule, not ours: Mosaic keeps accounts you are entitled to run apart, and does not change what a site allows.

If you are still choosing a seller, the proxies worth using with an anti-detect browser sets out what to look for, and rotating against sticky sessions explains which kind each job wants. Mosaic Pro is $49 a month for any number of profiles, with the first 14 days free, and Free holds 3 profiles.