BlueOnyx 5210R manual install

Please note: The recommended method to install BlueOnyx is to use the ISO image. However, as we're still trying to build the first 5210R ISO image you might want to use this method - if you are in a hurry to get BlueOnyx 5210R.

This instructions are for installing BlueOnyx 5210R on a RHEL8 or RHEL8 clone. Such as AlmaLinux 8, RockyLinux 8 or CentOS 8 (*Not* CentOS Stream!).


1.) Pre-installed AlmaLinux, RockyLinux or CentOS. Preferably with the package selection for "OS Builder" or "Minimal Install" chosen.

2.) Partitions & Filesystems: The partition layout doesn't matter. But if possible set up a separate /home partition, which has some benefits. But we can do without separate /home. The preferred filesystem for all partitions (except /boot and Swap) should be XFS (the CentOS 8 default), but can be EXT4 as well. BTRFS might work, too. But that is - at this time - untested by us.

2.) "root" access

3.) Working network connection and pre-configured network settings.

4.) SELinux must be disabled (see: /etc/selinux/config, SELINUX=disabled). The installer will turn it off if it's still on.


Log in as "root" by SSH or the console. Run this command to install the BlueOnyx 5210R YUM configuration files:

yum install

Then run this command to install BlueOnyx 5210R and all its dependencies:

yum groupinstall blueonyx

Let it grab and install the stuff. It'll be around 800-1200 RPMs. That kind of depends on your base install. This will take a while to finish.

After the RPMs have been installed via YUM you *must* run this command:


After you have run that script it will tell you to reboot. Please do so. DO NOT SKIP THE REBOOT!!!

This reboot is important, as the script reconfigured your Grub configuration to use traditional style network interfaces (ethX) and also did a few other steps that will kick in during the reboot Such as the creation the user "admin", which you need to login to the GUI. After the reboot login via the console or by SSH. If all went well your server should *not* have lost the network configuration during the reboot and the first CCEd start, so login via SSH should be possible.

If you login via the console you should see this screen after the reboot has finished:

Once you login as user "root" with password "blueonyx" the script /root/ will be executed automatically. Please do not abort it and follow through the options it guides you through.

If the CCEd constructors have not yet finished their initial run, then you will see this waiting screen:

Just wait until that is done and you will then be asked if you want to configure the IPv4 network settings. Confirm "yes" by pressing return if you plan on using IPv4. That will allow you to specify the server IPv4 IP Address, Network Mask, Gateway and the DNS server it should use. Afterwards it'll ask you if you want to configure IPv6. If you don't want to assign an IPv6 IP address, choose "no" and press enter. A summary screen will show you the network details and then the network settings will be applied.

Some required service restarts will happen automatically and then final screen confirms that your BlueOnyx 5210R is ready to use. It'll also show you how and where to reach the GUI interface.

Please note:

This install procedure only works for BlueOnyx 5210R. While the 5209R manual install was already pretty neat, the install procedure for BlueOnyx 5210R is by far the cleanest we've ever managed to roll out.

There are two notable differences between BlueOnyx 5210R and previous versions in regards to enabled services: Both "NetworkManager" and "Firewalld" are enabled by default. "NetworkManager" is now a must-have item, as RedHat/CentOS made it nearly impossible to configure the network without it. Even "/sbin/ifup" is now a shortcut to "NetworkManager" and that will only activate interfaces if they are under control of "NetworkManager". For added security we chose to enable "Firewalld" by default as well. It already has all common ports used by BlueOnyx open. You can however choose to disable Firewalld in case you don't like it being active. Disabling it has no negative effect on BlueOnyx itself.

Additionally: BlueOnyx 5210R has a slightly different FTP implementation than older versions of BlueOnyx and now also supports Chrooted Jailkit jails for allowing SCP, true SFTP and SSH. For more information on how that works please read this article. It also explains the new directory layout for Vsites and Users, which was a requirement for the Jailkit integration.

If you have any questions about or problems with the install procedure, then please ask on the BlueOnyx mailing list.