Installation¶

mcup can be installed on Linux using package managers, or manually on any platform (Linux, macOS, Windows) by cloning the repository.

Linux¶

Snap¶

Snap Support Dropped

Support for the Snap package has been dropped.

We have decided to discontinue Snap support due to significant maintenance overhead caused by the sandboxed environment and performance issues compared to native packages.

Existing Snap installations will no longer receive updates. We strongly recommend migrating to the .deb or .rpm packages.

Debian / Ubuntu (.deb)¶

Note

An APT release is planned. In the meantime, please install mcup using the .deb file.

Download the latest .deb package from GitHub Releases.
Install it using dpkg:

sudo dpkg -i ./mcup_*.deb
sudo apt-get install -f

Important

Replace ./mcup_*.deb with the actual path to your downloaded file.

RPM-based Distributions (.rpm)¶

Download the latest .rpm package from GitHub Releases.

Fedora / RHEL 8+ / Rocky / Alma:

sudo dnf install ./mcup_*.rpm

Older RHEL / CentOS (6-7):

sudo yum localinstall ./mcup_*.rpm

openSUSE:

sudo zypper install ./mcup_*.rpm

Important

Replace ./mcup_*.rpm with the actual path to your downloaded file.

Manual Installation (All Platforms)¶

You can install mcup manually by cloning the repository. This works on Linux, macOS, and Windows.

Prerequisites:

Git
Python 3

Steps:

Clone the repository:

git clone https://github.com/kacper-jar/mcup.git
cd mcup

Run the appropriate startup script:

Linux / macOSWindows

./mcup.sh <args>

mcup.bat <args>