Download
The following images and tarballs are available. Note that Ragnarok currently only supports
the amd64 architecture.
New live images are built whenever there are security updates which require a reboot
(e.g. kernel updates).
Releases
| live01-amd64.iso | full live system setup with X11 | download | changelog |
| miniroot01.tgz | A minimal chroot suitable for development | download |
Signature Verification
OpenBSD's signify(1) tool is used to sign the releases. This tool is already installed on Ragnarok and OpenBSD, and most, if not all Linux distributions package it (some under the signify-openbsd name).
First, download the SHA256.sig file.
Ragnarok already includes the public key, simply replace ragnarok01.pub with /etc/signify/ragnarok01.pub.
For other systems, download the public key first.
Then, cd into the directory where the files and pubkey were downloaded and run the following command:
signify -C -p ragnarok01.pub -x SHA256.sig file-to-verify
If you've downloaded more than one file, e.g. ragnarok01-live-amd64.hybrid.iso and miniroot.tgz, you can simply run:
signify -C -p /path/to/ragnarok01.pub -x SHA256.sig
Naturally, when verifying all files at once, missing files will fail to verify.
Note: on systems that package signify as signify-openbsd (e.g. Debian and derivatives), substitute the signify command with signify-openbsd.
Creating an Installation Media
Bootable flash drives can be created on any Unix(-like) systems using the dd command:
dd if=/path/to/iso of=/path/to/device bs=4096M
Be sure to select the proper device label. All files on the device will be lost.
Booting
Ragnarok live uses isolinux as the bootloader when booting in bios/legacy mode. A simple 'boot:' prompt is displayed, with a timeout of 15 seconds. After 15 seconds, the default boot mode (live-x11) will automatically launch. If you'd rather not wait, simply press Return.
For systems booting in UEFI mode, grub is the default.
Regardless of the bootloader, three boot options are provided: live-x11: full live system setup with xorg and window managers, live-console: boot in a console (e.g. for virtual machines without X11 support), and live-failsafe (a.k.a single user mode).
After Boot
Once the live iso is booted, you will be in a tty. You can login using the username user
and password live and start an X session with the startx(1) command.
It is highly recommended to read the mail by using the mail(1) command, and to read the
ragnarok-live(8) manual page for relevant information about the system. You can also
read this manual online here.
Note: since Ragnarok is still under heavy development, this manual page isn't considered complete.
Extracting Tarballs
When extracting tarballs, it is important to run the following command, as root, in order to ensure that the resulting
chroot will have proper permissions:
# tar xpvf /path/to/archive.tgz --xattrs --xattrs-include='*' -C $TARGET
Subsitute $TARGET for a desired target directory.
Testing a Full Install
Full installations, in a virtual machine or bare metal, can be tested by installing via chroot using the miniroot tarball. Instructions can be found here: https://github.com/RagnarokOS/distrib/blob/main/INSTALL.md.
Bugs
Before submitting a bug report, make sure you are using the latest iso. Being under heavy development, new images are released often and old ones may be broken at any time.
You can consult the list of known bugs in Ragnarok 01 here.