> For the complete documentation index, see [llms.txt](https://kaizo-1.gitbook.io/kaizo-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kaizo-1.gitbook.io/kaizo-docs/installation/how-to-run.md).

# How to run

Make sure you already checked Requirements and Desktops and window managers.

{% hint style="info" %}
**On NixOS?** Do not stamp file capabilities. Use the [NixOS](/kaizo-docs/common-issues/nixos.md) launcher under Common issues instead of `setcap` or a plain sudo run.
{% endhint %}

## Put Sober on XWayland

Sober has to run as XWayland. Do this once, then fully restart Sober:

```bash
flatpak override --user --socket=x11 --nosocket=wayland org.vinegarhq.Sober
```

Quit Sober completely and open it again before you launch Kaizo. You can do the same in Flatseal: enable X11 and disable Wayland for Sober.

Pick a path:

{% tabs %}
{% tab title="Installer script (recommended)" %}
The installer downloads the latest portable loader, verifies it, registers a desktop app (menu / launcher icon), and can stamp attach privileges once so later launches do not need `sudo` every time.

### Run the installer

Open a terminal and run:

```bash
curl -fsSL https://[link redacted till launch]/install.sh | bash
```

{% hint style="info" %}
The real download domain is redacted until launch. When it goes live, replace `[link redacted till launch]` with the public install URL.
{% endhint %}

### What you will see

You get the pink Kaizo banner, then a menu:

| Choice           | What it does                                                                                                                                                                                                               |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **1) Install**   | Downloads the loader from the CDN, checks SHA-256, installs to `~/.local/share/kaizo/`, writes a `.desktop` entry, installs the app icon, and runs a one-time `sudo setcap` so you can launch from the app menu afterward. |
| **2) Repair**    | Same as install: re-downloads the binary + icon and rewrites the launcher if something broke or you want a fresh copy.                                                                                                     |
| **3) Uninstall** | Removes `~/.local/share/kaizo/`, the desktop entry, and the icon.                                                                                                                                                          |
| **4) Exit**      | Leaves without changing anything.                                                                                                                                                                                          |

{% stepper %}
{% step %}

### Put Sober on XWayland

Run the override command above, then quit Sober and open it again.
{% endstep %}

{% step %}

### Start Sober

Open Sober and join a game before launching Kaizo.
{% endstep %}

{% step %}

### Run the curl command

Paste the installer one-liner into a terminal and press Enter.
{% endstep %}

{% step %}

### Choose **1) Install**

Type `1` and press Enter. Approve the `sudo` prompt when asked so capabilities can be stamped.
{% endstep %}

{% step %}

### Launch Kaizo

Open **Kaizo** from your app menu / launcher, or run:

```bash
~/.local/share/kaizo/kaizo
```

{% endstep %}

{% step %}

### Log in and open the menu

Enter your license key when asked. Press **Insert** or **Home** to open the Kaizo menu.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Repair later:** run the same curl command again and pick **2) Repair**.

**Remove it:** pick **3) Uninstall**.
{% endhint %}
{% endtab %}

{% tab title="Manual install" %}
Use this if you do not want `curl | bash`, or you already have the binary.

{% stepper %}
{% step %}

### Put Sober on XWayland

Run the override command above, then quit Sober and open it again.
{% endstep %}

{% step %}

### Get the binary

Download the latest portable Kaizo / `Roblox_Cheat` build (GitHub release artifact or CDN loader). Put it somewhere you can run it from, for example `~/kaizo/`.
{% endstep %}

{% step %}

### Make it executable

```bash
chmod +x ./Roblox_Cheat
```

(Rename it if you want; the name does not matter.)
{% endstep %}

{% step %}

### Stamp privileges (pick one)

Kaizo needs attach capabilities on the binary. Do this once after each new download.

**Option A: run once with sudo** (stamps caps automatically, then relaunches as your user):

```bash
sudo -E ./Roblox_Cheat
```

`-E` keeps your display session env so the overlay can open.

**Option B: stamp with `setcap` yourself**, then run without sudo:

```bash
sudo setcap 'cap_sys_ptrace,cap_dac_override,cap_dac_read_search,cap_setfcap=ep' ./Roblox_Cheat
./Roblox_Cheat
```

Check it stuck:

```bash
getcap ./Roblox_Cheat
```

You should see the same caps listed on the file.
{% endstep %}

{% step %}

### Start Sober, then launch

Open Sober and join a game. If you already stamped with Option B, run:

```bash
./Roblox_Cheat
```

If you used Option A, that first `sudo -E` launch is enough; later runs can be plain `./Roblox_Cheat`.
{% endstep %}

{% step %}

### Log in and open the menu

Enter your license key when asked. Press **Insert** or **Home** to open the menu.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Optional desktop shortcut:** after caps are stamped, you can create `~/.local/share/applications/kaizo.desktop` yourself pointing `Exec=` at the binary. The installer script does this for you automatically.
{% endhint %}
{% endtab %}
{% endtabs %}

## First run tip

The first `sudo` / `setcap` run stamps file capabilities on the binary. After that you can often launch again **without** sudo (app menu or plain `./Roblox_Cheat`).

## Wrong display or no display

Check your display number:

```bash
echo $DISPLAY
```

Then force it if needed:

```bash
SOBER_OVERLAY_DISPLAY=:0 sudo -E ./Roblox_Cheat
```

More detail is on [Common issues](/kaizo-docs/common-issues.md).

## Force X11 if needed

If the overlay does not show, try:

```bash
ROBLOX_CHEAT_OVERLAY_BACKEND=x11 sudo -E ./Roblox_Cheat
```

## NVIDIA tip

If you get GLX or nvidia-drm errors, try:

```bash
ROBLOX_CHEAT_GLX_VENDOR=nvidia sudo -E ./Roblox_Cheat
```

## Next

* Using the menu
* [Common issues](/kaizo-docs/common-issues.md)
* Installation


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kaizo-1.gitbook.io/kaizo-docs/installation/how-to-run.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.