For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt, and this page is available as Markdown at /en/guide/domestic-os.md.
  • English
  • 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.

    Check the architecture and pick a package

    Confirm the architecture in a terminal first:

    dpkg --print-architecture
    # or
    uname -m
    Command outputCommon platformsPackage
    amd64 / x86_64Hygon, Zhaoxin, Intel, AMDOctop-desktop-linux-amd64-1.0.3b5.deb
    arm64 / aarch64Kunpeng, PhytiumOctop-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:

    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
    arm64 / aarch64
    sudo apt update
    sudo apt install ./Octop-desktop-linux-amd64-*.deb

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

    amd64 / x86_64
    arm64 / aarch64
    sudo dpkg -i Octop-desktop-linux-amd64-*.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:

    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.