# Browser Setup

To access KayakNet services like `home.kyk`, you need to configure your browser to use the KayakNet proxy.

## Quick Setup

KayakNet provides two proxy types:

* **HTTP Proxy:** `127.0.0.1:8118`
* **SOCKS5 Proxy:** `127.0.0.1:8119`

## Browser-Specific Instructions

### Firefox (Recommended)

1. Open **Settings** (≡ → Settings)
2. Search for "proxy"
3. Click **Settings...** in Network Settings
4. Select **Manual proxy configuration**
5. Enter:
   * HTTP Proxy: `127.0.0.1` Port: `8118`
   * Check "Also use this proxy for HTTPS"
6. Click **OK**

**Alternative: Use SOCKS5**

* SOCKS Host: `127.0.0.1` Port: `8119`
* Select "SOCKS v5"
* Check "Proxy DNS when using SOCKS v5"

### Chrome / Edge / Brave

Chrome uses system proxy settings. You have two options:

**Option 1: System Proxy (Windows)**

1. Open Windows Settings
2. Network & Internet → Proxy
3. Manual proxy setup → On
4. Address: `127.0.0.1`
5. Port: `8118`

**Option 2: Extension (Recommended)**

1. Install "Proxy SwitchyOmega" extension
2. Create new profile "KayakNet"
3. Protocol: HTTP, Server: `127.0.0.1`, Port: `8118`
4. Apply changes
5. Click extension → Select "KayakNet"

**Option 3: Command Line**

```bash
chrome --proxy-server="http://127.0.0.1:8118"
```

### Safari (macOS)

1. System Preferences → Network
2. Select your connection → Advanced
3. Proxies tab
4. Check "Web Proxy (HTTP)"
5. Server: `127.0.0.1` Port: `8118`
6. Check "Secure Web Proxy (HTTPS)"
7. Server: `127.0.0.1` Port: `8118`
8. Click OK → Apply

### Tor Browser

Tor Browser is pre-configured for Tor. To use KayakNet instead:

1. Open `about:preferences#connection`
2. At the bottom, click "Settings..."
3. Select "Manual proxy configuration"
4. HTTP Proxy: `127.0.0.1` Port: `8118`
5. Restart browser

## Testing Your Setup

After configuring:

1. Navigate to `http://home.kyk`
2. You should see the KayakNet homepage
3. If you see an error, check:
   * KayakNet node is running
   * Proxy settings are correct
   * No other proxy is interfering

## Supported Domains

With the proxy configured, you can access:

| Domain            | Description                |
| ----------------- | -------------------------- |
| `home.kyk`        | KayakNet homepage          |
| `chat.kyk`        | Chat interface             |
| `market.kyk`      | Marketplace                |
| `marketplace.kyk` | Marketplace (alias)        |
| `domains.kyk`     | Domain registration        |
| `network.kyk`     | Network statistics         |
| `*.kyk`           | Any registered .kyk domain |

## Troubleshooting

### "Proxy Server Refused Connection"

* Ensure KayakNet node is running
* Check proxy port matches your configuration
* Try restarting the node

### "Unable to Connect"

* Verify proxy settings in browser
* Try HTTP proxy instead of SOCKS5
* Check for firewall blocking port 8118

### "Page Not Found" for .kyk domains

* The domain may not be registered
* Try `home.kyk` to verify proxy works
* Check if node is connected to network

### Slow Loading

* Wait for node to connect to peers
* First load may be slow due to onion routing
* Subsequent loads are faster due to caching

## Privacy Tips

### Do

* Use Firefox with enhanced tracking protection
* Clear cookies after sessions
* Use private/incognito mode

### Don't

* Log into personal accounts (Google, Facebook)
* Enable WebRTC (can leak real IP)
* Install untrusted extensions
* Mix KayakNet and regular browsing

### Disable WebRTC in Firefox

1. Open `about:config`
2. Search `media.peerconnection.enabled`
3. Set to `false`

## Dedicated Browser Profile

For best privacy, create a separate browser profile:

**Firefox:**

```bash
firefox -P  # Opens profile manager
# Create "KayakNet" profile
# Configure proxy only in this profile
```

**Chrome:**

```bash
chrome --user-data-dir="~/.kayaknet-chrome"
```

This keeps your KayakNet browsing completely separate from regular browsing.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kayaknet.io/getting-started/browser-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.