diff options
| author | RaindropsSys <contact@minteck.org> | 2023-07-02 18:27:10 +0200 |
|---|---|---|
| committer | RaindropsSys <contact@minteck.org> | 2023-07-02 18:27:10 +0200 |
| commit | 2b6af86904d4fa939d19b785fe456a861257c1b8 (patch) | |
| tree | d1948604697372c5c7da3b4e9d5d092810b5301e | |
| parent | 611753304d0f72f6c61337202659b79596bd7784 (diff) | |
| download | kirinos-2b6af86904d4fa939d19b785fe456a861257c1b8.tar.gz kirinos-2b6af86904d4fa939d19b785fe456a861257c1b8.tar.bz2 kirinos-2b6af86904d4fa939d19b785fe456a861257c1b8.zip | |
Updated 3 files and added docs/Installing-mangoOS-on-bare-metal.md (automated)
| -rw-r--r-- | core/launcher/index.html | 4 | ||||
| -rw-r--r-- | core/power/index.html | 4 | ||||
| -rw-r--r-- | core/status/index.html | 4 | ||||
| -rw-r--r-- | docs/Installing-mangoOS-on-bare-metal.md | 64 |
4 files changed, 73 insertions, 3 deletions
diff --git a/core/launcher/index.html b/core/launcher/index.html index 9f61577..233bfcb 100644 --- a/core/launcher/index.html +++ b/core/launcher/index.html @@ -54,7 +54,9 @@ <body> <script> window.addEventListener('error', (event, source, lineno, colno, error) => { - parent.transferError(error); + parent.transferError([ + event, source, lineno, colno, error + ]); return false; }); diff --git a/core/power/index.html b/core/power/index.html index 9a96add..b177802 100644 --- a/core/power/index.html +++ b/core/power/index.html @@ -64,7 +64,9 @@ <body> <script> window.addEventListener('error', (event, source, lineno, colno, error) => { - parent.transferError(error); + parent.transferError([ + event, source, lineno, colno, error + ]); return false; }); diff --git a/core/status/index.html b/core/status/index.html index 066532f..e0094c8 100644 --- a/core/status/index.html +++ b/core/status/index.html @@ -38,7 +38,9 @@ <body> <script> window.addEventListener('error', (event, source, lineno, colno, error) => { - parent.transferError(error); + parent.transferError([ + event, source, lineno, colno, error + ]); return false; }); diff --git a/docs/Installing-mangoOS-on-bare-metal.md b/docs/Installing-mangoOS-on-bare-metal.md new file mode 100644 index 0000000..61c4c22 --- /dev/null +++ b/docs/Installing-mangoOS-on-bare-metal.md @@ -0,0 +1,64 @@ +# Installing mangoOS on bare metal + +> **WARNING:** mangoOS is currently in development and is not yet suitable for daily use. As such, the installation process will be complicated, and you might run into issues. + +## Requirements + +* 64bit x86 processor (the ARM port is not yet available) +* 2GB of RAM or more +* 8GB of storage or more +* Decent GPU +* Network card supported by Debian +* Ethernet connection (very important, Wi-Fi is not supported yet) +* Access to git.equestria.dev through your firewall (if applicable) +* Lot of time +* USB stick containing Debian 12 (no other version is supported) +* For better integration, it is recommended that you use a UEFI-based system, although these instructions will work with BIOS-based systems as well + +## 1. Installing Debian +The first step into getting mangoOS up and running is to install Debian. Before you do anything, make sure your USB stick containing a copy of Debian 12 and your Ethernet cable are both plugged in. If your computer is running on battery, make sure it is sufficiently charged before continuing. + +To install Debian (these instructions are for the "netinst" image): +* Turn on your computer and make it boot from the USB stick +* On the menu, choose "Install" +* Select "English" as the language +* Select your correct region (this is used to set up your timezone) +* Use "United States" as the locale +* Select the keymap you want to use; we recommend you leave it on "American English" +* Select the correct network card to use (if applicable) +* Use "mangoos" as the hostname +* Leave "Domain name" as the default value +* Use "mangoos" as the root password +* Name the new user "mangoOS" with the username "mangoos" and the password "mangoos" +* Partition your disk as you wish; if you want to erase the entire disk, use "Guided - use entire disk" + * **Note:** Do NOT configure encryption here, mangoOS already comes with an encryption system that conflicts with LUKS. +* Make sure you have all files in the same partition, and that the resulting partition is at least 16GB +* Once the base installation is done, select the default mirror for your country, and configure a proxy if needed +* Select "No" on the package usage survey screen +* On the software selection screen, unselect "Debian desktop environment" as well as "GNOME" and select "SSH server", leave "standard system utilities" selected +* Install the GRUB bootloader on your system disk +* After the installation is complete, select "Go Back" and select "Execute a shell" and "Continue" +* Run `chroot /target`, and run `apt install -y git` +* Once you see the `#` symbol again, press Ctrl+D twice and select "Finish the installation" +* After everything is complete, select "Continue" and remove the USB stick while your system is restarting + +## 2. Installing mangoOS +You have now installed Debian. Log in as `mangoos` with the password `mangoos`. + +You now need to follow these instructions to install mangoOS: +* Run `su` and enter the password `mangoos` +* Run the following command: + * `git clone https://git.equestria.dev/equestria.dev/mangoos /mango` +* Wait for it to download mangoOS +* Run `cd /mango` +* Run `chmod +x setup.sh`, and then `./setup.sh` +* You are now installing the required dependencies and configuring your Debian installation to run mangoOS. This will take a while, so take a break while it's working +* Once everything is done, open /etc/network/interfaces (`nano /etc/network/interfaces`) and remove the lines related to the primary network interface (usually starts with `enp0s`), then press Ctrl+S and Ctrl+Q to save and quit +* Run `/sbin/reboot` to restart the system +* If the screen turns orange shortly after starting up, you have reached the first state of the mangoOS startup process +* The screen may flicker a few times during the rest of the boot process +* Once the "Welcome to mangoOS" message appears, your system is installed properly +* After the boot process has completed, click on the "Owner" user and login using the "password" password + +## Wrapping up +blah blah
\ No newline at end of file |