> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Platforms

# Platforms

Agdi core is written in TypeScript. **Node is the recommended runtime**.
Bun is not recommended for the Gateway (WhatsApp/Telegram bugs).

Companion apps exist for macOS (menu bar app) and mobile nodes (iOS/Android). Windows and
Linux companion apps are planned, but the Gateway is fully supported today.
Native companion apps for Windows are also planned; the Gateway is recommended via WSL2.

## Choose your OS

* macOS: [macOS](https://agdiai-597e782f.mintlify.site/platforms/macos.md)
* iOS: [iOS](https://agdiai-597e782f.mintlify.site/platforms/ios.md)
* Android: [Android](https://agdiai-597e782f.mintlify.site/platforms/android.md)
* Windows: [Windows](https://agdiai-597e782f.mintlify.site/platforms/windows.md)
* Linux: [Linux](https://agdiai-597e782f.mintlify.site/platforms/linux.md)

## VPS & hosting

* VPS hub: [VPS hosting](https://agdiai-597e782f.mintlify.site/vps.md)
* Fly.io: [Fly.io](https://agdiai-597e782f.mintlify.site/install/fly.md)
* Hetzner (Docker): [Hetzner](https://agdiai-597e782f.mintlify.site/install/hetzner.md)
* GCP (Compute Engine): [GCP](https://agdiai-597e782f.mintlify.site/install/gcp.md)
* Azure (Linux VM): [Azure](https://agdiai-597e782f.mintlify.site/install/azure.md)
* exe.dev (VM + HTTPS proxy): [exe.dev](https://agdiai-597e782f.mintlify.site/install/exe-dev.md)

## Common links

* Install guide: [Getting Started](https://agdiai-597e782f.mintlify.site/start/getting-started.md)
* Gateway runbook: [Gateway](https://agdiai-597e782f.mintlify.site/gateway.md)
* Gateway configuration: [Configuration](https://agdiai-597e782f.mintlify.site/gateway/configuration.md)
* Service status: `agdi gateway status`

## Gateway service install (CLI)

Use one of these (all supported):

* Wizard (recommended): `agdi onboard --install-daemon`
* Direct: `agdi gateway install`
* Configure flow: `agdi configure` → select **Gateway service**
* Repair/migrate: `agdi doctor` (offers to install or fix the service)

The service target depends on OS:

* macOS: LaunchAgent (`ai.agdi.gateway` or `ai.agdi.<profile>`; legacy `com.agdi.*`)
* Linux/WSL2: systemd user service (`agdi-gateway[-<profile>].service`)


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