> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peeksee.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Peeksee Connect

> Connect the cameras on your local network to your Peeksee workspace.

Peeksee Connect runs on a computer at your business. In Peeksee, that installation is called a **gateway**. It connects to cameras on the local network and lets authorized viewers watch through the portal without forwarding camera ports through your router.

## Before you start

* Choose a Windows or Linux computer, or a Docker host, that stays powered on while cameras are in use.
* Confirm that it can reach the cameras and the internet.
* Have administrator access to that computer and permission to add gateways in Peeksee.
* Decide which business location this gateway should serve.

## Install and claim the gateway

1. In your business workspace, open **Gateways → Add gateway**.
2. Choose **Windows**, **Linux**, or **Docker**.
3. Use the installer or command shown in the wizard. The wizard supplies the current installation details.
4. On the gateway computer, open `http://localhost:8787/`.
5. Create a local administrator username and password. If an account already exists, sign in with it.
6. Copy the eight-character claim code shown in the local console.
7. Return to Peeksee, choose **I have a claim code**, and enter it. Set the gateway's name and location as prompted.
8. Complete the claim and wait for the gateway to report online.

The local administrator account belongs to that Connect installation. It is separate from your Peeksee sign-in.

## Remote Linux hosts

If the computer has no local browser, use an SSH tunnel from your computer:

```bash theme={null}
ssh -L 8787:127.0.0.1:8787 user@gateway-host
```

Replace `user@gateway-host` with your own SSH login and host. Keep the connection open, then visit `http://localhost:8787/` in your browser.

For Docker with mapped ports, follow the Compose instructions shown by the wizard to set the local administrator password before signing in.

## Confirm it is ready

Check the gateway status and its most recent contact with Peeksee. Then [add a camera](https://docs.peeksee.app/connect/add-cameras.md) and confirm that live video plays.

If the gateway stays offline, check its power, network connection, and running service. [Troubleshoot camera connections](https://docs.peeksee.app/troubleshooting/cameras.md) before removing or reinstalling it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.