Profile routing runbook

Incogniton Proxy Integration

Configure Databay HTTP or SOCKS5 proxies in Incogniton: Proxy Library setup, bulk adds, per-profile assignment, country targeting, sticky sessions, verification, troubleshooting, and local-API automation. With safety boundaries.

Incogniton

Multi-profile browser

P-01
P-01 / Profile routingOne profile, one sticky exitserver-rendered route map

Profile 01

approved settings + cookies

Session control

sessionId-profile01

Stable exit

countryCode-us

Keep cookies, storage, country selection and the proxy session attached to the same authorized profile.

Staged guide · editorial review pending8 min runbook

Operating principle

Keep cookies, storage, country selection and the proxy session attached to the same authorized profile.

What Is Incogniton

Incogniton is a multi-profile browser for Windows 10/11 (64-bit) and macOS (Apple Silicon and Intel) that isolates cookies, storage, and fingerprint surfaces between browser profiles. Each profile behaves like a separate machine, which teams use for authorized client workspaces, QA environments, and account security. The free plan includes 10 browser profiles; REST-API and Selenium automation, the Synchronizer, and team management are gated to paid tiers. Do not use fingerprint controls to impersonate people, create fake accounts, or bypass platform enforcement - profile isolation is an operations tool, not an identity fabricator.

Why Pair Incogniton With Databay

The pairing works because Databay exposes one managed gateway - gw.databay.co:8888 - where product, country, and session requests live in the proxy username, while Incogniton exposes a Proxy Library that its documentation describes as a central place to manage and reuse proxy configurations. Save one Databay entry per workspace so the intended routing configuration remains associated with that profile without retyping credentials. The actual exit can rotate or a sticky request can end early, so verify it instead of treating an IP as a permanent profile identity.

Prerequisites

You need a Databay account with the gateway host, port, and username:password pair from the dashboard, and Incogniton installed (free plan is enough for manual setup; automation needs a paid tier). Plan the proxy username per workspace before touching the UI: USER-zone-residential-countryCode-us-sessionId-client01 style flags decide pool, geography, and stickiness per profile. Keep credentials in a password manager - never embed production secrets in screenshots or shared templates.

Add Databay to the Proxy Library

Incogniton's documented flow: open Proxy Library from the left-side menu and click + New proxy (top right).

  1. Pick the connection type - the current documentation shows HTTPS or SOCKS5. Databay supports HTTP proxying, HTTPS CONNECT tunnelling, and SOCKS5, but this guide has not live-validated how Incogniton labels the HTTP/CONNECT path; select a compatible mode and require the built-in check to pass.
  2. Fill Proxy (ip:port) with gw.databay.co:8888, then Proxy username and Proxy password. Shortcut: pasting gw.databay.co:8888:USERNAME:PASSWORD straight into the ip:port field auto-populates the remaining fields.
  3. Optionally set a Display name, a Group, and Notes - name entries after the workspace whose sessionId flag they carry, so the library maps one-to-one onto your workflows.
  4. Leave the Rotating proxy toggle off: Databay rotation and optional stickiness are controlled by the username, so the rotation-URL field has no job here. Without a sessionId, new connections use rotating pool selection, but a different IP on every connection is not guaranteed.
  5. Click Check to verify the connection, then Add - or Add to list to stage several entries first.
For fleets, click Bulk add at the bottom left of the form and paste one proxy per line as ip:port:username:password, or load a CSV with the same per-row format; the Group dropdown assigns all pasted entries at once. One hundred Databay lines usually means one hundred sessionId or countryCode variations of the same gateway.

Assign the Proxy to a Profile

Each profile's Proxy tab offers four documented options: Proxy Library, Buy proxy, Custom proxy, and Free proxy. For Databay:

  1. Choose Proxy Library, then Select from Proxy Library, and pick the saved workspace entry - no credentials re-entered.
  2. Or choose Custom proxy and enter the connection type and gateway details directly, then click Check "to verify connectivity" before saving. Use custom entries for one-off exceptions; the library is the pattern for anything reused.
  3. Incogniton offers IP-derived language, timezone, and location defaults. Treat them as observed settings and verify them after connection; a requested Databay country is not a guarantee that every derived value will match.
Click Save; the proxy appears in the profiles list, and Launch opens the browser through the configured gateway. Verify the actual exit. Skip Incogniton's built-in Free proxy option for real workspaces: its own docs note the shared IPs "carry the history of all users" and recommend switching to a dedicated proxy once accounts are involved.

Country Targeting and Sticky Sessions

Geography and persistence are Databay username flags, so the same library mechanics cover every case. Add -countryCode-us when an authorized test needs a US network origin. Add -sessionId-client01 when the workflow needs temporary continuity: Premium Residential, Datacenter, and Mobile accept requested sticky windows up to 120 minutes, while Residential Flex accepts up to 30 minutes. Upstream availability can change the exit before that requested maximum, and the route is not a dedicated device or permanent address. Use a separate session label for each profile that needs a separate logical session, but do not assume labels guarantee different underlying IPs. Choose residential or datacenter by required network origin, controls, measured workload result, and cost; compare the documented facts on the residential and datacenter pages.

Verify the Network Path

Verify at three layers before trusting a profile. First, the Check button in the Add proxy form or profile editor must pass. Second, read Incogniton's documented status icons in the profiles list: a red cancel icon means the profile failed to launch on a proxy connection error, while a red lightning bolt with the green check means the proxy is slow but working - a latency signal, not a failure. Third, inside the launched profile, open the Databay IP checker and confirm the exit IP and country match the username's countryCode flag. If your direct address appears instead, stop before signing in to anything and fix the assignment. For debugging outside Incogniton, its docs recommend testing the same credentials in Firefox with FoxyProxy - if the proxy works there but not in Incogniton, the mismatch is in the profile configuration, not the gateway.

Troubleshooting Connection Failures

Incogniton's troubleshooting doc frames failures as "a mismatch between what your proxy expects and what's configured in Incogniton", and the same four mismatches cover Databay setups:

  • Protocol mismatch - a SOCKS5 entry created under the HTTPS connection type (or vice versa) fails the check. Recreate the entry with the type that matches the credentials you tested.
  • Missing port - the ip:port field needs gw.databay.co:8888, not the bare host.
  • Wrong auth mode - Databay gateway entries use username:password; if the account is configured for IP-allowlist auth instead, the credential fields must be empty and the machine's IP must be on the allowlist.
  • Environment leaks - if the exit is right but the page behaves oddly, Incogniton suggests manually setting timezone, WebRTC, and geolocation by disabling the three Fill-based-on-IP toggles; with a correctly matched Databay country flag the defaults are usually the safer choice.
Still stuck? Test the identical credentials once with curl outside Incogniton to establish which side is misconfigured.

Automate With the Local API

On paid tiers, the Incogniton desktop app exposes a local REST API at http://localhost:35000 (the app must be running and the profile status Ready). Profile operations cover POST /profile/add, GET /profile/all, /profile/launch/{profile_id}, /profile/status/{profile_id}, and /profile/stop/{profile_id}, so fleets can be provisioned and driven programmatically while each profile retains its configured Databay routing settings. For browser automation, POST /automation/launch/puppeteer with {"profileID": "..."} returns a puppeteerUrl you connect to with puppeteer-core (puppeteer.connect({ browserURL, acceptInsecureCerts: true })), and GET /automation/launch/python/{profile_id} starts a Selenium-compatible session - the docs allow around 30 seconds for browser initialization. The runtime patterns are the same as our Puppeteer and Selenium runbooks; the difference is that Incogniton owns the browser and stores the proxy configuration with the profile. The exit can still rotate or a sticky request can end early.

Choose Residential or Datacenter by Requirement

Residential and datacenter pools provide different network origins, documented controls, observed availability, latency, and price. Choose from the authorized test requirement and measure the exact workload; neither origin is a universal performance or acceptance upgrade. Do not switch pools or session IDs to route around a 403, 429, CAPTCHA, or other source control; stop, back off, or use an approved API or access method instead.

Operational Safety

Maintain written account authorization, role-based access, multifactor authentication, profile ownership, access logs, and offboarding. Incogniton's team features (roles with granular permission categories, including dedicated Proxy Library permissions on paid tiers) map cleanly onto that discipline - use them to keep who-can-touch-which-exit explicit. Give profiles separate storage for security, not as invented identities. Apply source terms and one domain-level request budget across all profiles. Databay's Acceptable Use Policy prohibits spam, deceptive engagement, and unauthorized access.

Troubleshooting desk

Questions specific to Incogniton

Should I choose HTTPS or SOCKS5 in Incogniton?
Incogniton documents HTTPS and SOCKS5 connection types. Databay supports HTTP proxying, HTTPS CONNECT tunnelling, and SOCKS5 on gw.databay.co:8888, but this guide has not live-validated Incogniton's current HTTP/CONNECT label. Select a compatible mode, require Incogniton's Check result to pass, and verify the route in the browser. Databay managed products do not promise SOCKS4.
Can several profiles share one Proxy Library entry?
Yes - that is what the library is for - but profiles sharing one entry also share its routing and session configuration. Use one library entry and a distinct sessionId label per workspace that needs a separate logical sticky request. Separate labels do not guarantee different underlying IPs in a shared pool, so verify the observed exits when separation is material.
How do I keep the same IP during a profile session?
Put a sessionId flag in the Databay username of that profile's library entry. Premium Residential, Datacenter, and Mobile accept requested sticky windows up to 120 minutes; Residential Flex accepts up to 30 minutes. Upstream availability can end continuity earlier. The result is not a permanent or dedicated address, so verify the observed exit at the start and during continuity-sensitive work.
How many proxies can I add at once?
Use Bulk add at the bottom left of the Add proxy form: one proxy per line as ip:port:username:password, or a CSV with the same per-row format, with a Group assigned to the whole batch. For Databay that usually means many username variations - different countryCode or sessionId flags - of the same gateway.
Why does Incogniton's proxy check fail when the credentials work elsewhere?
The usual mismatches per Incogniton's own troubleshooting doc: connection type doesn't match the proxy (HTTPS entry for SOCKS5 credentials), the port is missing from the ip:port field, or username/password entered for an account that authenticates by IP allowlist. Its docs also recommend re-testing in Firefox with FoxyProxy to isolate which side is misconfigured.
Should I use Incogniton's free built-in proxies instead?
Not for real workspaces. Incogniton's docs say the free proxies' shared IPs "carry the history of all users" and recommend a dedicated proxy once account management is involved - they position them for general browsing and testing profile configurations only.
Adjacent runbooks

Same gateway, different control surface

  • GoLogin

    Multi-profile browser

    Location column -> external proxy -> connection check -> assigned profile

  • Dolphin Anty

    Multi-profile browser

    Proxy screen -> connection check -> saved route -> assigned profile

  • AdsPower

    Multi-profile browser

    Proxies list -> per-profile flags -> pinned exits

  • Axios

    HTTP client library

    Axios request -> route selector -> absolute-form or CONNECT -> hop evidence

  • cURL

    Command-line client

    curl -> proxy auth -> CONNECT or SOCKS -> approved destination

  • Node.js fetch

    HTTP client library

    fetch -> env opt-in or same-package dispatcher -> proxy evidence

  • Python Requests

    HTTP client library

    Session -> HTTPAdapter policy -> proxy hop -> approved destination

  • Playwright

    Browser automation

    Browser process -> isolated contexts -> independent exit sessions

  • Puppeteer

    Browser automation

    --proxy-server -> page.authenticate() -> page.goto()

  • Scrapy

    Crawler framework

    Request queue -> downloader middleware -> rotating exit pool

  • Selenium

    Browser automation

    WebDriver -> auth decision -> Databay gateway

Choose the exit pool after the control path works. Choose residential for an ISP-origin route or datacenter for a hosting-network route, then measure the authorized workload.

Residential →Datacenter →

Where teams run Incogniton behind the gateway: Proxies for social media operations · Proxies for e-commerce accounts

Ship Incogniton to production

Create an account, drop in your gateway credentials, and route your first Incogniton request in minutes.

Pricing, order minimums, and traffic validity vary by product.