This is an old revision of the document!

Migrate your Parabola GNU/Linux-libre to Hyperbola GNU/Linux-libre

Complete migration

Install Hyperbola keyring and mirror list

Install Hyperbola keyring package (distributed by Parabola) and mirror list for Hyperbola repositories in /etc/pacman.d/mirrorlist:

# pacman -S hyperbola-keyring
# pacman -U

Rename mirrorlist.pacnew as mirrorlist:

# cp /etc/pacman.d/mirrorlist.pacnew /etc/pacman.d/mirrorlist

Remove Parabola repositories

Remove every lines about nonprism, libre, pcr in /etc/pacman.conf since we have our libre packages inside core, extra, community and multilib repos. See our Repositories article for further info.

You can use our default pacman.conf files for i686 and x86_64 as references.

Replace Parabola packages with Hyperbola ones

Clean the pacman cache:

# pacman -Scc

Force the database sync:

# pacman -Syy

Update to libre packages:

# pacman -S pacman
# pacman -Suu base
If you want to ignore extra prompts and accept all confirmations over replaced packages, you can optionally use –noconfirm
If some of your packages have higher version than in Hyperbola repos they will be downgraded to lower version of our packages since we are a long-term support distro.
Hyperbola is a long-term support distro based on Arch plus stability and security from Debian. It isn't a rolling release distro like Parabola because Hyperbola is using Arch snapshots for its versions and Parabola's blacklist as base to keep it 100% libre. Also Hyperbola is using Debian patches, therefore all packages are being stabilized with improvements through its development. See the Packaging Guidelines and Social Contract for further details.

Update bootloader configuration

Please update either GRUB or Syslinux, 'but not both', as it would cause a kernel panic.


For grub regenerate your grub.cfg file running:

# grub-mkconfig -o /boot/grub/grub.cfg
Check for more information


Manually change following lines in /boot/syslinux/syslinux.cfg to reflect change:

  LABEL hyperbola
     MENU LABEL Hyperbola GNU/Linux-libre
     LINUX ../vmlinuz-linux-libre-lts
     INITRD ../initramfs-linux-libre-lts.img
  LABEL hyperbolafallback
     MENU LABEL Hyperbola GNU/Linux-libre Fallback
     LINUX ../vmlinuz-linux-libre-lts
     INITRD ../initramfs-linux-libre-lts-fallback.img
Since Hyperbola is a long-term support distro, linux-libre-lts is our default kernel.

Alternatively you can remove the configuration file and reinstall syslinux.

Other bootloaders


Since Hyperbola has announced the end of systemd support, migration to OpenRC is required. See our migration article for further details.

Complete the migration

Restart your system - it should boot into Hyperbola.

After installation

Welcome, you are now in Hyperbola! If you find any trouble applying these instructions please report it on our Bug Tracker!


This wiki article is based on ParabolaWiki.