> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wednesdayai.dev/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+
2. `npm i -g openclaw@latest`
3. `wednesdayai 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

Step-by-step VPS guide: [exe.dev](https://docs.wednesdayai.dev/next/admin/install/exe-dev.md)

## Install

* [Getting Started](https://docs.wednesdayai.dev/next/users/start/getting-started.md)
* [Install & updates](https://docs.wednesdayai.dev/next/admin/install/updating.md)
* Optional flows: [Nix](https://docs.wednesdayai.dev/next/admin/install/nix.md), [Docker](https://docs.wednesdayai.dev/next/admin/install/docker.md)

## Gateway

* [Gateway runbook](https://docs.wednesdayai.dev/next/admin/gateway.md)
* [Configuration](https://docs.wednesdayai.dev/next/admin/gateway/configuration.md)

## Gateway service install (CLI)

Use one of these:

```text theme={"dark"}
wednesdayai onboard --install-daemon
```

Or:

```text theme={"dark"}
wednesdayai gateway install
```

Or:

```text theme={"dark"}
wednesdayai configure
```

Select **Gateway service** when prompted.

Repair/migrate:

```text theme={"dark"}
wednesdayai doctor
```

## System control (systemd user unit)

WednesdayAI 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://docs.wednesdayai.dev/next/admin/gateway.md).

Minimal setup:

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

```text theme={"dark"}
[Unit]
Description=WednesdayAI Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

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

[Install]
WantedBy=default.target
```

Enable it:

```text theme={"dark"}
systemctl --user enable --now wednesdayai-gateway[-<profile>].service
```


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