---
id: platform_installation.linux
page_type: download_article
title: "Moonbot for Linux"
description: "Run Moonbot on Linux with a self-contained executable image that includes Arch Linux, Wine, and the required components. Download the package and launch the Windows-based trading terminal on Linux."
section: download
category: null
url: https://moonbot.pro/moonbot-pro/download/linux?format=md
locale: en
alternate_ru: https://moonbot.pro/ru/moonbot-pro/download/linux?format=md
alternate_zh: https://moonbot.pro/zh/moonbot-pro/download/linux?format=md
parent: https://moonbot.pro/moonbot-pro/download?format=md
previous: null
next: null
status: published
updated_at: 2026-11-18T00:16:10+03:00
---

# Moonbot for Linux

A standalone executable container image containing a minimal Arch Linux distribution with pre-installed Wine and the necessary components to run Moonbot, designed for Windows.

## Requirements

- Installed packages: fuse3 (or fuse/fuse2) and coreutils
- Permission to execute files from the /tmp directory (allowed by default in most distributions).
- Linux kernel with user namespaces support (required for the container to work).
- An installed and configured graphical desktop environment.

### Installing dependencies on popular distributions

**Debian / Ubuntu**

`sudo apt install fuse3 coreutils`

**RHEL / CentOS / AlmaLinux**

`sudo dnf install fuse3 coreutils`

---

## Launch

For Moonbot to start correctly, the packages `fuse3` (or `fuse` version 2) and `coreutils` must be installed on the system.

The file system of the `/tmp` directory must also allow binary files to be executed (no `noexec` option). Most modern distributions are configured this way by default.

Moonbot can be launched either from a command-line terminal or through the graphical shell.

For the first launch, make the file executable:

`chmod +x MoonBot`

After that, simply run it without options:

`./MoonBot`

With no additional command-line parameters, the Moonbot terminal starts with the preset Wine and container settings.

---

## Supported distributions

**Debian 12** is recommended, but operation has also been verified on the following distributions:

- **Debian:** 11, 12
- **Ubuntu:** 20.04, 22.04, 24.04
- **RHEL / CentOS based:** AlmaLinux 9.5, RockyLinux 9.5\
  *Compatibility is expected with any distribution based on RHEL 9 or later*

---

## Known issues

Newer versions of Moonbot on Linux currently do not work because of an incompatibility with Wine.

**Do not update the terminal version**, otherwise it may stop launching.

To roll back the version after an update, reset with the `-R` option (the terminal settings are kept):

`./MoonBot -R`\
`./MoonBot`

---

## Description

Moonbot for Linux is a standalone executable container image that includes a minimal Arch Linux distribution with pre-installed Wine and all the components needed to run the Windows version of Moonbot.

The whole build is packaged into a single executable file and requires no installation or additional dependencies on the user’s side.

The main purpose of this build is to provide a stable, isolated and simple environment for running Moonbot on Linux.

Unlike the classic approach of installing Wine and libraries by hand, the container provides a fully ready solution and minimizes the chance of conflicts with host system packages and configuration differences.

In addition, the image already includes Moonbot for Windows itself.

### Advantages of this approach

- **Simplified deployment.**  There is no need to install and maintain up-to-date versions of Wine and its dependencies.
- **Environment isolation.** All changes and user settings are stored in a separate working directory of the container and do not affect the host system.
- **Compatibility.** The container uses unprivileged user namespaces (via bubblewrap), OverlayFS and FUSE (version 2 or 3) and does not require additional tools such as Docker or root access.

**Technology stack:** Conty, bubblewrap, and user namespaces.

---

## Filesystem and persistence

The container image is read-only by default. At runtime, OverlayFS is used to enable a read-write layer.

All changes are stored in the following directory:

`$HOME/.local/share/MoonBot/overlayfs`

The Moonbot working directory inside the container is located at:

`$HOME/.local/share/MoonBot/overlayfs/opt/MoonBot`

For convenience, a symbolic link is created in the user’s home directory:

`$HOME/.config/MoonBot → $HOME/.local/share/MoonBot/overlayfs/opt/MoonBot`

Running the container does not affect system-wide Wine settings or the host OS configuration.

---

## Alternative launch without the container

If an up-to-date version of Wine is already installed on the system (version 9.x minimum, version 10.0 or higher recommended), Moonbot can be launched directly.

For optimal performance, support for vkd3d and all related dependencies is also recommended.

Moonbot can be started with the following command:

`wine MoonBot.exe`

---

## System configuration

On some distributions (for example, Ubuntu), unprivileged user namespaces may be disabled.

If required, they can be enabled manually using the following command:

`sudo sysctl kernel.unprivileged_userns_clone=1`

For Ubuntu 24.04 and newer, an additional setting is required:

`sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0`

---

## Command-line options

The Moonbot container supports the following startup options:

`-h` — display help information

`-r` — reset the container while preserving the Moonbot working directory and settings

`-R` — same as `-r`, but also attempts to restore overwritten Moonbot binaries (recommended after a failed update)

`-RESETFULL` — **destructive mode**, performs a full reset of the container, removing all data and settings

To display the help text, run:

`./MoonBot -h`

---

![Moonbot for Linux](https://moonbot.pro/storage/media/Banner/image_en/47/conversions/01KBAGTJRQ2Y60QVFZQTTZJ4A6-optimized.png)

A container image packaged into a single executable file, designed to run Moonbot on Linux OS desktop using Wine.

- [Download](https://api.moonbot.pro/files/MoonBot-linux-demo.zip)

## Navigation

Path: [Main](https://moonbot.pro/?format=md) / [Moonbot PRO](https://moonbot.pro/moonbot-pro?format=md) / [Download Moonbot](https://moonbot.pro/moonbot-pro/download?format=md) / Moonbot for Linux

Parent section: [Download Moonbot](https://moonbot.pro/moonbot-pro/download?format=md)
