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

# Linux App

# Linux App

The Gateway is fully supported on Linux. **Node is the recommended runtime**.
Bun is not recommended for the Gateway (WhatsApp/Telegram bugs).

Native Linux companion apps are planned. Contributions are welcome if you want to help build one.

## Beginner quick path (VPS)

1. Install Node 24 (recommended; Node 22 LTS, currently `22.14+`, still works for compatibility)
2. `npm i -g agdi@latest`
3. `agdi onboard --install-daemon`
4. From your laptop: `ssh -N -L 18789:127.0.0.1:18789 <user>@<host>`
5. Open `http://127.0.0.1:18789/` and paste your token

Full Linux server guide: [Linux Server](https://agdiai-597e782f.mintlify.site/vps.md). Step-by-step VPS example: [exe.dev](https://agdiai-597e782f.mintlify.site/install/exe-dev.md)

## Install

* [Getting Started](https://agdiai-597e782f.mintlify.site/start/getting-started.md)
* [Install & updates](https://agdiai-597e782f.mintlify.site/install/updating.md)
* Optional flows: [Bun (experimental)](https://agdiai-597e782f.mintlify.site/install/bun.md), [Nix](https://agdiai-597e782f.mintlify.site/install/nix.md), [Docker](https://agdiai-597e782f.mintlify.site/install/docker.md)

## Gateway

* [Gateway runbook](https://agdiai-597e782f.mintlify.site/gateway.md)
* [Configuration](https://agdiai-597e782f.mintlify.site/gateway/configuration.md)

## Gateway service install (CLI)

Use one of these:

```
agdi onboard --install-daemon
```

Or:

```
agdi gateway install
```

Or:

```
agdi configure
```

Select **Gateway service** when prompted.

Repair/migrate:

```
agdi doctor
```

## System control (systemd user unit)

Agdi installs a systemd **user** service by default. Use a **system**
service for shared or always-on servers. The full unit example and guidance
live in the [Gateway runbook](https://agdiai-597e782f.mintlify.site/gateway.md).

Minimal setup:

Create `~/.config/systemd/user/agdi-gateway[-<profile>].service`:

```
[Unit]
Description=Agdi Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/agdi gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
```

Enable it:

```
systemctl --user enable --now agdi-gateway[-<profile>].service
```


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