> For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt.

# Use Octop on domestic operating systems

This page covers installing Octop on domestic desktop systems. It currently includes UnionTech UOS and Kylin. Both use a `.deb` package. Download the package that matches this machine from the [Octop v1.0.3b5 release](https://github.com/TencentCloud/Octop/releases/tag/v1.0.3b5).

## Check the architecture and pick a package

Confirm the architecture in a terminal first:

```bash
dpkg --print-architecture
# or
uname -m
```

| Command output      | Common platforms           | Package                                 |
| ------------------- | -------------------------- | --------------------------------------- |
| `amd64` / `x86_64`  | Hygon, Zhaoxin, Intel, AMD | `Octop-desktop-linux-amd64-1.0.3b5.deb` |
| `arm64` / `aarch64` | Kunpeng, Phytium           | `Octop-desktop-linux-arm64-1.0.3b5.deb` |

## Install

### Install from the terminal

Prefer `apt install ./<package>.deb`. It installs the deb and pulls missing libraries from the system repositories.

Open a terminal and go to the directory that holds the package, for example `~/Downloads`:

```bash
cd ~/Downloads
```

Update the package index, then install. Keep the `./` in front of the file name so apt installs the package in the current directory.


**amd64 / x86_64**

```bash
sudo apt update
sudo apt install ./Octop-desktop-linux-amd64-*.deb
```


**arm64 / aarch64**

```bash
sudo apt update
sudo apt install ./Octop-desktop-linux-arm64-*.deb
```


If you use `dpkg -i` and it reports missing dependencies, fix them with the command below:


**amd64 / x86_64**

```bash
sudo dpkg -i Octop-desktop-linux-amd64-*.deb
# If it reports dependency problems, run:
sudo apt-get install -f -y
```


**arm64 / aarch64**

```bash
sudo dpkg -i Octop-desktop-linux-arm64-*.deb
# If it reports dependency problems, run:
sudo apt-get install -f -y
```


### Double-click the package

- **UnionTech UOS:** In the file manager, double-click the `.deb` to open **Package Installer**. Click **Install** and enter the administrator password.
- **Kylin:** Double-click the `.deb` to open **Kylin Package Installer** or the **Software Store**. Click **One-click install** or **Install**, then enter the password.

After it finishes, search for Octop in the **app launcher** or the **start menu**.

## Common problems

### UOS says signature verification failed

UOS desktop editions refuse third-party packages that are not signed by the official store.


### Open Developer Mode

Open **Control Center → General → Developer Mode**.

### Activate it

Click **Enter Developer Mode**. Sign in to a UnionTech account to activate online, or import a certificate offline.

### Restart, then install

Restart when prompted, then install the deb again.

### Kylin security policy blocks the app

Some Kylin desktops enforce execution protection or an allow list. Open **Kylin Security Center**, add Octop to the allow list under application execution control, or lower the security level.

### The icon does nothing

When the icon in the app menu does nothing, run the program from a terminal and read the error:

```bash
octop
```

You can also run the executable installed under `/opt` or `/usr/bin`. The log often shows a missing `.so`, or a failure in GPU hardware acceleration. On older graphics chips, start it again with `--disable-gpu`.
