> ## Documentation Index
> Fetch the complete documentation index at: https://geonode.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# GeeLark
> How to Set Up Geonode Proxy in GeeLark
***
This guide will help you configure a Geonode proxy in the GeeLark browser, both for mobile and desktop profiles.
You'll learn how to:
* Add and manage Geonode proxies in GeeLark
* Create mobile and desktop profiles
* Set up device environments
* Launch virtual profiles and test if proxies work
Whether you're browsing from a phone-like virtual device or a desktop profile, this step-by-step guide covers everything you need.
***
## Prerequisites: Get Proxy Credentials from Geonode
Before setting up a proxy, first, retrieve your proxy credentials from the Geonode dashboard.
* Follow this guide: [How to Obtain Proxy Server Information](/proxy-setup/prerequisites/proxy-server-information)
***
## **Steps: Setting Up a Proxy in GeeLark**
Follow these steps to configure a proxy in GeeLark:
### Install GeeLark
1. Go to the [GeeLark Download Page](https://www.geelark.com/).
2. Download the browser based on your operating system.
3. Install the software and create an account.
***
## For Mobile
### Step 1: Create a New Profile
1. Open GeeLark and click the **New Profile** button.
2. Enter the required details:
* Profile name
* Operating system
3. On the right side, review your browser details.
***
### Step 2: Add a Proxy
You can add a proxy while creating a profile, or manage them separately from the Proxies tab before profile setup.
#### Option A: Add Proxies First (Recommended for Bulk Management)
1. Go to the Proxies tab from the sidebar.
2. Click the Add proxy button.
3. Use the format shown to enter your proxy:
```
proxy.geonode.io:9000:geonode_username:password
```
You can also use:
```
username:password@host:port
```
Or
```
http://username:password@proxy.geonode.io:9000
```
4. Select your Type as HTTP, and set:
* Proxy group: e.g., Geonode Proxies
* IP query channel: Use ip-api for geolocation
5. Add one proxy per line. You can add up to 100 at once.
6. Once added, the proxy will automatically show up in the table with details like:
* Type: HTTP, HTTPS, or SOCKS5
* Proxy host and Port
* Username and Password
* Remark (Optional comment)
* Proxy group (e.g., "Geonode Proxies")
* IP Query Channel: Use `ip-api` to resolve export IP
* Export IP (resolved after testing)
7. Click the Proxy tests button. It will check whether the proxy is active and display:
* The resolved country and IP address
* A green arrow icon showing the proxy is working
* A timestamp of the successful test
#### Option B: Add Proxy During Profile Creation
1. While creating a profile, navigate to the Proxy tab.
2. Select your proxy Type (e.g., HTTP).
3. Enter these fields manually:
* Proxy: Your Geonode proxy IP and Port (e.g., proxy.geonode.io:9000)
* Username: Your Geonode username
* Password: Your Geonode password
4. Choose IP Query Channel like ip-api to test your proxy live.
5. Click Check Proxy to verify that it's working.
***
### Step 3: Create and Launch the Profile
Now that your proxy is configured, let's complete the profile setup by choosing your device settings and launching the profile.
#### 1. Fill in Profile Settings
1. Click the New Profile button.
2. Under Profile Settings, you can:
* Give the profile a name (optional).
* Select the Operating System (Android or iOS).
* Add Group, Tags, and a Remark to keep your profiles organized.
#### 2. Set Up Proxy Settings
Choose how to add the proxy:
##### Option A: Custom Proxy
* Select Custom
* Fill in:
* Type: HTTP, HTTPS, or SOCKS5
* Host: proxy.geonode.io
* Port: 9000
* Username and Password
* Set IP Query Channel (e.g., IP2Location or ip-api)
* Click Check Proxy to test your connection.
If working, it will show your proxy's country, city, ISP, and IP details.
##### Option B: Saved Proxies
* Select Saved proxies
* Choose a proxy group (e.g., Geonode Proxies)
* Pick a specific proxy from the list
* Click Check Proxy to confirm it's active
#### 3. Choose Device Information
Under Device Information, you can customize how the virtual mobile device behaves.
* Charging Method: Pay per minute or Monthly rental
* Version:
* Select Android version (e.g., Android 12, 13, 15)
* All versions support camera, sound, and app uploads
* Network: Wi-Fi or Cellular Network
* Phone Number: Auto-generated or Custom
* Area: Based on IP (auto matches proxy location) or Custom
* Device Brand & Model: Random or Custom
* Language: Based on IP or select manually
#### 4. Create and Launch the Profile
1. Once you’ve completed all settings, click the Create button at the bottom of the form.
2. After the profile is created, it will appear in the Profiles list with all your selected details like OS version, proxy region, remark, and tags..
3. To launch the virtual mobile device, click the Action (▶️) button next to your profile.
4. A new window will open with the mobile device. You can now:.
* Open any browser
* Test if your proxy is working
* Visit a website like ip-api.com to check the IP, location, and ISP of your configured proxy.
***
## For Desktop
Follow these steps to configure a Geonode proxy in a desktop profile in GeeLark.
### Step 1: Create a New Desktop Profile
1. In the GeeLark panel, click the New Profile button.
2. On the top right, switch to the Desktop icon (🖥️).
3. Under Profile Settings, enter:
* Profile Name (optional)
* Group (optional)
* Tags (optional)
* Remark (any helpful note for you)
4. Choose your Operating System: Windows or macOS
5. Select the Browser (e.g., Kiwi Browser).
6. The User-Agent field will auto-generate based on your OS and browser, or you can customize it.
7. Cookie: (Optional) Paste session cookies in JSON or Netscape format if you want to retain logins or states from another session.
8. Remark: Write any internal notes for future reference — like the goal of this profile or special usage instructions.
***
### Step 2: Set Proxy for Desktop Profile
The proxy setup for desktop works the same way as on mobile.
* Option A: Use a Custom Proxy
* Option B: Use a Saved Proxy
***
### Step 3 (Optional): Account
You can optionally configure:
* Platform Account Info (login credentials if needed for specific websites)
* Set startup behavior:
* Reopen recent tabs
* Open a custom web page at launch
***
### Step 4 (Optional): Advanced Settings
GeeLark also allows you to fine-tune fingerprinting and device behavior under the Advanced Settings panel.
You can customize:
* Time zone, language, and geolocation
* WebRTC, Canvas, WebGL, AudioContext
* Resolution, font, and device hardware
* Noise-based fingerprint controls (e.g., for Media Devices, ClientRects, SpeechVoices)
* Device properties like storage, battery, Bluetooth, concurrency, and port scan protection
These settings help improve anonymity, simulate real devices, or match specific test conditions.
### Step 5: Review device information
On the right-hand panel, you'll see device information, a summary of the fingerprint and environment settings for your desktop profile.
This includes:
* Browser and OS
* User-Agent
* Time zone
* WebRTC and geolocation options
* Language, canvas, WebGL, fonts, and more
You can also click "Generate a new fingerprint" to refresh the device identity. This helps avoid detection when using multiple accounts or automating browser sessions.
### Step 6: Launch the Desktop Profile
Once everything looks good:
1. Click the Create button
2. The profile will now show up in your profile list
3. Click the Action button (▶️) to launch the desktop profile
4. Open a browser tab and visit a test site like `https://ip-api.com` to confirm your Geonode proxy is active and your IP, location, and ISP match expectations
***
If you encounter any issues, refer to the [**troubleshooting section**](/knowledge-base/troubleshooting/proxy-not-working) or [**Geonode support**](/additional-resources/support).
***
## **FAQs**
If your connection fails, check the following:
* Ensure that your proxy credentials (IP, Port, Username, Password) are correct.
* Verify that your proxy is active in the Geonode Dashboard.
* Try another proxy format if the selected one isn't working.
* Refer to this guide for troubleshooting: [Troubleshooting Proxy Connection Issues](/knowledge-base/troubleshooting/pages-not-loading)
* You may be using a Sticky Session proxy that keeps the same IP for a certain duration.
* If using a Rotating Session, verify that your requests are being routed through the proxy correctly.
* Check your connection using an IP verification tool: [Verify Proxy Connection](https://ip-api.com/)
* Some websites detect **frequent IP changes** and show CAPTCHAs as a security measure.
* Use Sticky Sessions if you need a stable connection.
* Try switching to a mobile or residential proxy for lower detection rates.
* High latency can occur if the proxy server is far from your location.
* Try using a different proxy region to improve speed.
* Reduce the number of simultaneous requests to avoid overloading the proxy.
* This can happen if the proxy authentication credentials are not correctly stored or passed by your browser or application. Ensure that the correct username and password are saved in your proxy settings.
* Or you can whitelist your IP. Refer to this guide for [How to Whitelist an IP](/proxy-setup/advance-configuration/whitelist-ip)