# Gateway Devices

Gateway devices bridge the gap between your local hardware and your Genie cloud environment. By connecting a phone, laptop, or other device as a gateway, you enable direct communication between your local system and your cloud server.

***

## What Gateway Devices Do

A gateway device creates a secure, persistent connection between your local machine and your Genie server.

This enables:

* Running local commands from your Genie dashboard
* Syncing files between local and cloud environments
* Tunneling local services to your cloud server
* Receiving notifications on your device

***

## Supported Devices

Gateway connections are supported on:

* iOS and Android (mobile apps)
* macOS and Windows (desktop apps)
* Linux (CLI tool)
* Raspberry Pi and similar hardware

***

## How It Works

Your gateway device connects to your Genie server through a secure WebSocket connection. Once paired, commands and data can flow in both directions.

The connection is authenticated using one-time pairing codes and secured with encryption. Tokens are rotated automatically.

***

## Use Cases

**Hybrid Development** — Work on files locally while running and testing on your cloud server. Changes sync automatically between environments.

**Mobile Access** — Use your phone as a command interface for your cloud server, even without opening a browser.

**Local Service Tunneling** — Expose a service running on your local machine to your cloud server through a secure tunnel.

**IoT and Automation** — Connect devices like Raspberry Pi to your Genie server for data processing, monitoring, or automation workflows.

***

## Security

You control exactly what each gateway device can do:

* Read files
* Write files
* Execute commands
* Send notifications

Permissions are configured per device and can be revoked at any time. All communication is encrypted end-to-end.

***

## Managing Devices

Connected devices are visible in your channel settings. You can view their status, rename them, adjust permissions, or disconnect them at any time.

Multiple devices can be connected simultaneously, each with independent permissions and access levels.