Skip to main content

Debian Guide (x64) - untested (WIP)

This Installation Guide will allow you to install the MaXXdesktop on a Debian Linux Distribution from version 9 and above.

We cannot confirm if it works 100% for all derivatives of Debian, but it should. For Devuan users pay attention to the POST Installation.

 
Release Notes for Octane Alpha v2.2.0

Backup Older MaXXdesktop Installation

To guaranty a successful installation or upgrade, we still recommend to backup your current MaXXdesktop installation.  Follow the simple instructions below.

It is VERY IMPORTANT to backup your older MaXXdesktop installation outside a running MaXXdesktop session.  Ideally from the text console or from another desktop session like GNOME or KDE.

1. Backup you current MaXXdesktop Installation.

$ su -
cd /opt
mv MaXX MaXX-old
exit
$

2. Run the following commands (AS ROOT) to remove deprecated files from older version 2.0 of MaXXdesktop.

This step is optional in case you modified or installed old MaXX GTK Themes. At this point you probably know what you're doing...

$ su -
rm /usr/share/themes/IndigoMagic
rm /usr/share/themes/Rio
rm /usr/share/themes/Gotham
rm /usr/share/themes/MaXX*
exit
$

separator-blue-line.pngPrerequisites

Below are the prerequisites for installing and running MaXXdesktop and some older X11/Motif applications...

System Requirements

Supported 64 bit (x86_64) Linux distribution running on an Intel or AMD CPU.
Minimum of 8GB recommended, althought MaXXdesktop runs fine on 4GB. Be warn of OOM Killer (oom_repear).

Storage Space Requirements

250MB   in  /tmp  partition (something it is part of the / 'root' partition)
800MB   in  /opt  partition (something it is part of the / 'root' partition)

Software Package Requirements

$ su -
apt-get update
apt-get install cpp libjpeg62-turbo libgtk2.0-0
apt-get install pavucontrol                 <-- Audio control panel in MaXX Desktop

// Debian 9
apt-get install lib64tinfo5 

// Debian 10+ and Devuan Beowulf
apt-get install libtinfo5


// Older xfonts required as a backward compatibility safety net
apt-get install xfonts-100dpi xfonts-75dpi 

// Mandatory Fonts for Modern Look
apt-get install fonts-dejavu fonts-noto fonts-noto-core fonts-noto-extra fonts-noto-ui-core fonts-noto-ui-extra fonts-noto-mono

exit
$

separator-blue-line.pngInstallation

Now let's install the MaXX Interactive Desktop onto your system.  Follow the simple instructions to download and run the installer.

You will need  superuser access to run some of the commands...

1. Download and Install MaXX Interactive Desktop-Octane v2.2.0

cd /tmp
wget https://s3.ca-central-1.amazonaws.com/cdn.maxxinteractive.com/maxx-desktop-installer/MaXX-Desktop-LINUX-x86_64-2.2.0-beta-final-Installer.sh
chmod a+x MaXX-Desktop-LINUX-x86_64-2.2.0-beta-final-Installer.sh
su or sudo -s
/tmp/MaXX-Desktop-LINUX-x86_64-2.2.0-beta-final-Installer.sh
exit

separator-blue-line.png

Post Installation

We recommend to backup your User Preferences.

1. Run the following commands (UNDER YOUR NORMAL USER) to backup your MaXXdesktop User Preferences.

$ cd $HOME
$ mv .maxxdesktop dot.maxxdesktop-back
$

separator-blue-line.png

Almost Done

Log out or simply restart your computer to allow your Display Manager (we recommend lightDM with our custom backgrounds) to take into account the new addition.

Once your system is rebooted, you can now choose MaXX Interactive Desktop  from  GDM's available session menu.

To customize your environment, refer to this book.

Congratulation and Welcome to MaXXdesktop!