Skip to content
GeckoLinux edited this page Oct 16, 2022 · 43 revisions

SpiralLinux Documentation

How to create a bootable SpiralLinux USB stick

In Windows:

  1. https://etcher.io
  2. http://wiki.rosalab.com/en/index.php/ROSA_ImageWriter

Important note: "Rufus", "LinuxLive USB Creator (LiLi)", and "Ventoy" for Windows are NOT recommended due to many reports of failure.

In Linux:

Updating and upgrading SpiralLinux

Updates within a Debian Stable release lifecycle

In Synaptic, Reload the package lists and then Mark All Upgrades and hit Apply 1

Upgrading to a major new Debian Stable release

  1. In the Synaptic Settings > Repositories interface, disable all of the repositories in the Debian Software tab 2
  2. In the Other Software tab disable all repositories and then enable the Debian Stable (for upgrades) repository 3
  3. Back in the main Synaptic interface, Reload the package lists and then Mark All Upgrades and hit Apply 1
  4. After rebooting into the upgraded system, re-enable these repositories: 4 5
  5. If Backports are needed, re-enable the repository and update it with the new Debian release name 6
  6. Disable the Debian Stable (for upgrades) repository

Switching from Debian Stable to the Testing or Unstable branch

Important: Debian's Testing and Unstable branches may work very well for some users' needs, but they do not claim to be stable releases and should only be used with extra care by experienced users.

  1. In the Synaptic Settings > Repositories interface, disable all of the repositories in the Debian Software tab 2
  2. In the Other Software tab disable all repositories and then enable the Debian Testing or Debian Sid ("Unstable") repository 7
  3. Back in the main Synaptic interface, Reload the package lists and then Mark All Upgrades and hit Apply 1

Updating a Debian Testing or Unstable system

Important: Debian's Testing and Unstable branches may work very well for some users' needs, but they do not claim to be stable releases and should only be used with extra care by experienced users.

In Synaptic, Reload the package lists and then Mark All Upgrades and hit Apply 1

Working with Btrfs snapshots and rollbacks

  • By default SpiralLinux uses Btrfs with a subvolume layout conducive to booting read-only snapshots and performing proper rollbacks.
  • Package additions or removals via apt will automatically trigger the creation of a snapshot via the Snapper mechanism, and these can optionally be managed with the Snapper GUI tool.
  • In the rare event that the system becomes unbootable, use the SpiralLinux snapshots section of the GRUB boot menu to select a working snapshot, taking note of the snapshot number, and boot into it. If needed the Snapper GUI tool will also be available in the snapshot system to determine which snapshot number to use for the rollback. Then to perform the rollback open a terminal and run: sudo snapper-rollback X where X is the number of the snapshot to rollback to.
    • Note: After performing a rollback, the Plasma applications menu may still be using an old cached version of the available applications. To regenerate it the Synaptic package manager can be used to add or remove applications, or else by running the command: sudo update-desktop-database

How to install non-English input methods?

Please see this guide created by an Asian user:

About the SpiralLinux "Builder" edition

The SpiralLinux "Builder" edition is not appropriate for most users. Unlike the other SpiralLinux editions, the "Builder" spin is not at all polished, intended instead as a base for experienced users to build on and configure according to their preferences. It basically contains a bare IceWM shell, a web browser, a graphical text editor, a few GUI configuration tools, and the Calamares installer. Many of the low-level packages and configurations are already present, leaving the experienced user to install additional programs and configure the theming.

Download SpiralLinux "Builder"

FAQs

  • Why does the GRUB bootloader entry say "Debian (SpiralLinux...) GNU/Linux"?
    • Debian's version of GRUB for EFI is hard-coded to look for the bootloader name debian, and so the GRUB entry needs to start with the the word "Debian". The "GNU/Linux" bit is added by the Debian GRUB scripts and can not be easily removed. At any rate, SpiralLinux is Debian, so it is not a priority to remove all references to that fact.
  • Why is the clock not using 24h format?
    • Some editions of SpiralLinux use a custom time/date format. Simply use the desktop environment's settings to disable the custom format and/or specifically enable 24h time format.
Clone this wiki locally