# 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.