This is an old revision of the document!

Quickstart guide

This page is under construction

Information is not guaranteed to be accurate or complete

Welcome to the Halyde quickstart guide! This guide will show you how to get Halyde up and running.

To install Halyde, you will need:

A computer
An internet card
Storage to install to
OpenOS floppy

There are 2 versions of Halyde you can install:

Installing Halyde 2

To install Halyde 2, you can use the Halyde webinstaller.

First you must boot into OpenOS, either through an already installed copy or from the installer floppy. Once you're in, paste in the following command: pastebin run MB21BTMv

If that doesn't work for some reason, try: wget -f https://raw.githubusercontent.com/Team-Cerulean-Blue/Halyde/refs/heads/main/webinstall.lua /tmp/webinstall.lua && /tmp/webinstall.lua

Once you run the installer, you will be greeted with the disk selection screen. If you have one drive that can be installed to on your computer, you will see a screen like this.

Figure A

You can press Y to install Halyde, or N to cancel and exit the installer. Installing Halyde will erase all data on the disk!

If you instead have 2 or more drives that you can install Halyde to, you will see a screen like this.

Figure B

Use the up and down arrow keys to select a drive and press Enter. You will then be brought to a screen that looks like Figure A, and you can follow the same instructions there.

Once you start installing, a progress bar will display on the bottom and show how much has been installed. After installation is complete, the computer will automatically reboot into Halyde.

Installing Halyde 3

Installing Halyde 3 is a bit more of an involved process. Please note that Halyde 2 apps are not compatible with Halyde 3.

There are 3 main ways of installing Halyde 3, but first you must pick the flavor, or branch, of Halyde 3 you would like to install.

Currently there are 2 options available:

cutting-edge, more stable (recommended to use)
bleeding-edge, newer but less stable (recommended for development)

You can either:

Installing Halyde 3 using gitget

This method assumes you have installed Halyde 2 and currently have an internet card. It is also the only way to install Halyde 3 when you cannot directly access the folder of your drive (i.e. on a server you don't own).

First, run the command ag install gitget, then press Y. This will use Halyde's Argentum package manager to install the gitget tool. Then, run gitget.

The tool will prompt you for a repository name. Type Team-Cerulean-Blue/Halyde and hit Enter.

Next, it will ask you for a branch name. Type in the branch you chose in the previous section and hit Enter.

Then, it will ask you where to download to. You should enter a drive short ID (like b79 for example) corresponding to where you want to install Halyde 3 and hit Enter.

Finally, it will ask you to confirm the install path. It should look something like /mnt/b79/, for example. Before confirming, check what you have entered in with the image below, keeping in mind that the branch should correspond to your selection, and the install path should correspond to your disk.

Figure C

Once you have checked to make sure everything is correct, type Y and hit Enter. If the details are incorrect, type N instead and hit Enter, then run gitget again and start over.

After confirming, the download process will start. This could take a few minutes, so wait for the completion message.

Once finished, you can run boot <drive id>, replacing <drive id> with the actual ID or short ID where you installed Halyde 3, like boot b79 for example.

Downloading Halyde 3 from GitHub

This method requires that you have access to the folder where your drive is, or that you are using an OpenComputers emulator (like Ocelot which allows you to choose a folder for your drive. If you do not have that, try using gitget.

To download Halyde 3 from GitHub, first you must locate the folder for the drive you want to install to. To do this,

Using Git to download Halyde 3