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

# Linux

> Install ZeroGPU Edge on Linux desktops, servers, and cloud VMs.

ZeroGPU Edge runs on Linux as the `zerogpu-edge` systemd service, under its own sandboxed user. It starts at boot and serves inference while the machine is available, with or without a desktop. See the [agent overview](https://docs.zerogpu.ai/edge/agent.md) for how fleets earn and for every setting.

## Requirements

| Requirement | Value |
| - | - |
| **Distributions** | Ubuntu and Debian (`.deb`); Fedora, RHEL, and Rocky Linux (`.rpm`). systemd is required. |
| **glibc** | 2.30 or newer, for example Ubuntu 20.04+, Debian 11+, or RHEL / Rocky 9+. The package refuses to install on older systems such as RHEL 8. Language models (llama.cpp) need glibc 2.34 on x86\_64 or 2.38 on ARM64; below that, the machine serves the other models. |
| **Architecture** | x86\_64 (amd64) or ARM64 (aarch64) |
| **GPU (optional)** | NVIDIA (CUDA) or a Vulkan-capable GPU. Without one, the machine serves models on the CPU. |
| **Credentials** | Your fleet's SDK key (`zgpu-sdk-…`) from the [Edge Operator Portal](https://edge.zerogpu.ai) |
| **Install rights** | root / `sudo` |

## Download

From [apps.zerogpu.ai/edge](https://apps.zerogpu.ai/edge?os=linux), replacing `<version>` with the current version shown there:

| Distribution | x86\_64 | ARM64 |
| - | - | - |
| Ubuntu / Debian | `zerogpu-edge_<version>_amd64.deb` | `zerogpu-edge_<version>_arm64.deb` |
| Fedora / RHEL / Rocky | `zerogpu-edge-<version>-1.x86_64.rpm` | `zerogpu-edge-<version>-1.aarch64.rpm` |

Check the download against the `SHA256SUMS` file published alongside it:

```bash theme={null}
sha256sum zerogpu-edge_*_amd64.deb
```

## Install

> [tab] Desktop
>
> Open the package with your desktop's software installer. The ZeroGPU Edge page opens afterwards and asks for your SDK key; select **Save and start**.

> [tab] Terminal
>
> ```bash theme={null}
> # Ubuntu / Debian (asks for the key during install)
> sudo apt install ./zerogpu-edge_<version>_amd64.deb
>
> # Fedora / RHEL / Rocky
> sudo dnf install ./zerogpu-edge-<version>-1.x86_64.rpm
> sudo zerogpu-edge configure --operator-key "zgpu-sdk-your-key" --restart
> ```

> [tab] Servers and automation
>
> For cloud-init, Ansible, Terraform, or images, install the package and write the settings to `/etc/zerogpu-edge/edge.env` instead of running `configure`:
>
> ```bash /etc/zerogpu-edge/edge.env theme={null}
> ZGPU_OPERATOR_KEY_FILE=/etc/zerogpu-edge/operator.key
> ZGPU_CUST_PARAM1=site-a
> ```
>
> Put the key in `/etc/zerogpu-edge/operator.key` (mode `0640`, owner `root:zerogpu-edge`), then:
>
> ```bash theme={null}
> sudo systemctl enable --now zerogpu-edge
> ```

## Configure

The settings table is on the [agent overview](https://docs.zerogpu.ai/edge/agent.md#configuration).

```bash theme={null}
sudo zerogpu-edge configure --resource-policy scheduled --schedule "mon-fri 18:00-08:00; sat-sun 00:00-24:00" --restart
```

## Verify

```bash theme={null}
zerogpu-edge status
systemctl status zerogpu-edge
```

The status shows the service registered and serving. Then confirm the machine in the portal: [Verify devices](https://docs.zerogpu.ai/edge/verify.md).

## Uninstall

```bash theme={null}
sudo apt remove zerogpu-edge     # Ubuntu / Debian
sudo dnf remove zerogpu-edge     # Fedora / RHEL / Rocky
```

## Troubleshooting

| Symptom | Fix |
| - | - |
| Service waiting for a key | Run `sudo zerogpu-edge configure --operator-key … --restart`, or open **ZeroGPU Edge** from the applications menu. |
| GPU not used | Run `zerogpu-edge doctor` to see which accelerators it found. Install the NVIDIA driver or Vulkan loader for your distribution. |
| Logs | `journalctl -u zerogpu-edge` |
| Anything else | See [agent troubleshooting](https://docs.zerogpu.ai/edge/agent.md#troubleshooting). |


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