SCREENERBOTDocs
DocsGetting StartedInstallation GuideLinux
Installation / Linux desktop

Install ScreenerBot on Linux desktop

Choose a native DEB or RPM package for system integration, or use the portable ZIP on another compatible distribution.

Getting Started/Installation/Linux desktop

Distributions

Debian, Ubuntu, Fedora, and compatible

Architecture

x64 or ARM64

Runtime

GLIBC 2.29 or later

Packages

DEB, RPM, or portable ZIP

Before you download

Use DEB on Debian, Ubuntu, Linux Mint, Pop!_OS, and compatible systems. Use RPM on Fedora, RHEL-family, and compatible systems. Match x64 or ARM64 to the machine.

Open verified downloads

System requirements

  • A desktop Linux distribution with GLIBC 2.29 or later
  • x64 or ARM64 processor
  • 4 CPU cores and 4 GB RAM minimum; 8 GB RAM recommended
  • 5 GB free disk space for the app and local runtime data

Choose the package deliberately

Debian family

DEB package

Use apt with the local-file prefix so dependencies are handled by the package manager.

Fedora family

RPM package

Use dnf or another distribution package manager that supports local RPM files.

Advanced

Portable ZIP

Use the complete extracted desktop bundle without package-manager integration.

Install the selected package

Follow only the method that matches the file you downloaded. Do not mix package and portable steps.

DEB package

Debian family

Use apt with the local-file prefix so dependencies are handled by the package manager.

  1. 1

    Download the DEB matching the processor architecture.

  2. 2

    Open a terminal in the download directory.

  3. 3

    Install the local package with apt.

  4. 4

    Launch ScreenerBot from the application menu or terminal.

Install

sudo apt install ./ScreenerBot*.deb

Launch

screenerbot

RPM package

Fedora family

Use dnf or another distribution package manager that supports local RPM files.

  1. 1

    Download the RPM matching the processor architecture.

  2. 2

    Open a terminal in the download directory.

  3. 3

    Install the local package through dnf.

  4. 4

    Launch ScreenerBot from the application menu or terminal.

Install

sudo dnf install ./ScreenerBot*.rpm

Launch

screenerbot

Portable ZIP

Advanced

Use the complete extracted desktop bundle without package-manager integration.

  1. 1

    Download the ZIP matching the processor architecture.

  2. 2

    Extract the complete archive to a stable directory.

  3. 3

    Make the packaged executable runnable if required.

  4. 4

    Launch it from the extracted application directory.

Extract

unzip ScreenerBot-*-Linux-*.zip

Find and launch

APP="$(find . -maxdepth 3 -type f -name ScreenerBot -print -quit)" && chmod +x "$APP" && "$APP"

Verify the first launch

  1. 1

    Launch ScreenerBot from the application menu or terminal.

  2. 2

    Confirm the native app window opens and the first-run setup is visible.

  3. 3

    Confirm the XDG data directory is created after first launch.

  4. 4

    Review RPC, wallet, filtering, and automation controls before enabling trading.

Local data directory

$XDG_DATA_HOME/ScreenerBot

When XDG_DATA_HOME is unset, the usual fallback is ~/.local/share/ScreenerBot.

Configuration, encrypted wallet material, databases, and logs persist here independently of the installed application.

Troubleshooting

Resolve installation and first-launch problems without deleting the data directory unless a guide explicitly requires it.

The DEB reports missing dependencies

Repair package dependencies, then repeat the apt installation if necessary.

sudo apt-get install -f

GLIBC is too old

Check the installed version. Use a newer distribution when it is below 2.29, or build the application from source on the target system.

ldd --version

The portable app reports permission denied

Run the portable launch command again from the directory where you extracted the complete archive.

The desktop window does not open

Confirm you downloaded a desktop package rather than the headless server binary and that a graphical session is available.

Uninstalling

  1. 01Quit ScreenerBot before removing its package.
  2. 02Use the same package manager that installed it.

Debian / Ubuntu

sudo apt remove screenerbot

Fedora / RHEL

sudo dnf remove screenerbot

Application removal is not data removal

Package removal keeps wallets, configuration, databases, and logs under the XDG data directory. Back up what you need before deleting it manually.

Next stepConfigure wallet, RPC, and safety controls