Installation

Install Regolith on your computer.

Based on your preferred installation method, follow one of the following two sections to install Regolith:

Option 1: Ubuntu Installer

  1. Download an ISO image (both the Ubuntu LTS 18.04 and most recent 19.10 bases are available) and then use an OS installation tool such as USB Creator to write the downloaded file into a USB device. Here are Ubuntu guides for performing this action in Windows, Mac, and Ubuntu.
  2. Reboot the computer and select the USB flash drive to boot from.
  3. Install or run the live environment by providing information when prompted during the setup process. See this tutorial to learn more about the installation process.
  4. When prompted, reboot the computer and login to your new Regolith environment!

Option 2: PPA

  1. See below about PPA sources, and add your chosen PPA to your system:
$ sudo add-apt-repository ppa:regolith-linux/release
  1. Install the Regolith desktop package:
$ sudo apt install regolith-desktop
  1. Reboot the computer, and when logging in select the “Regolith” session in the gear menu (⚙️):

Ubuntu Login Screen

Reinstallation

In the case that the Regolith desktop environment becomes corrupted or otherwise unbootable, follow these steps to reset it. No user files will be removed as part of this process:

  1. Login to the stock Ubuntu session. If this session is not available, install it with sudo apt install ubuntu-session. If you are unable to login, type ctrl alt F2 to access a TTY. After installing ubuntu-session, you will have the option to select the Ubuntu session type in the login screen.
  2. Uninstall Regolith from within the Ubuntu session:
$ sudo apt remove regolith-*
$ sudo apt autoremove
  1. Verify that no regolith packages are still installed with apt list --installed | grep -i regolith. The command should not return any packages. If it does, manually uninstall them with sudo apt remove <package>.
  2. Reinstall Regolith:
$ sudo apt install regolith-desktop
  1. Reboot the computer, and when logging in select the “Regolith” session in the gear menu. At this point you can remove or keep ubuntu-session.

Uninstallation of regolith-desktop

Simply follow these steps to remove Regolith from your system:

  1. Log out of the Regolith session and into the default Ubuntu session.
  2. Open a terminal and run:
$ sudo apt remove regolith-desktop regolith-st && sudo apt autoremove
  1. Now remove the PPA:
$ sudo add-apt-repository --remove ppa:regolith-linux/release
  1. To restore your GNOME settings, run:
$ source ~/.regolith-gnome-backup
  1. You can safely delete the file ~/.config/regolith.

PPA Sources

There are 4 sources for Regolith packages for release 1.3. The release PPA is recommended for most users, but another may be better for you based on your needs. Here is a description of each PPA.

Name PPA URI Freshness Stability Description
Unstable ppa:regolith-linux/unstable Very High Low The unstable PPA is recommended for project developers and anyone that's alright with troubleshooting their own system and doesn't mind some problems from time to time.
Stable ppa:regolith-linux/stable High Medium The stable PPA is for those that would like the latest features, even between official releases.
Release ppa:regolith-linux/release Low High The release PPA provides bug fixes as they occur and feature updates upon release.
r1.3 ppa:regolith-linux/r1.3 Very Low Very High The r1.3 PPA is locked to the 1.3 release and will not be updated except for critical bug fixes.

Last modified February 4, 2020: Add TTY info for upgrade issues on 19.04. (1c0eb71)