added an installation guide

docs/index.md

@@ -20,6 +20,7 @@ PsychOS is a multi-user cooperative multitasking operating system for OpenComput
 
 ### Documentation
 
+- [Installation guide](install.html)
 - User guide (WIP)
 - [Building PsychOS](building.html)
 - [API documentation](api.html)

docs/install.md

@@ -0,0 +1,64 @@
+# Installing PsychOS
+
+## Step 0: Information
+PsychOS requires the following hardware:
+- 150K RAM
+- 40K storage, preferably on its own disk
+
+In addition, this guide assumes the machine has an internet card to download files with. It's possible to install PsychOS from an existing copy but that is out of scope of this guide.
+
+You will want to know the address of the disk you plan to install PsychOS onto.
+
+## Step 1: Obtaining and booting a copy of PsychOS
+From OpenOS:
+
+```
+cd /tmp
+wget https://oc.shadowkat.net/PsychOS/build/fsdev/PsychOS-fsdev-latest/severything.lua init.lua
+init.lua
+```
+
+The 'same file' error is normal.
+
+These commands will reboot your machine into PsychOS running from the computer's temporary filesystem. Following this, you should see something like
+
+```
+PsychOS 83e2673 on 404cf459,  256K memory
+lush v1/Lua 5.2
+[superuser@404cf459 /boot]#
+```
+
+## Step 2: Downloading to a disk
+From your prompt, you'll want to invoke pkg to download a copy of PsychOS onto a disk. The path of the disk is /<the first 3 characters of the disk address>/
+
+```
+[superuser@404cf459 /boot]# pkg install https://oc.shadowkat.net/PsychOS/build/fsdev/PsychOS-fsdev-latest/psychos-latest.pkr /<disk>/
+```
+
+This will take a while, but will output progress.
+
+Once that has completed, power your machine off and take out all but the disk you installed PsychOS onto, then boot it up.
+
+## Step 4: Configuration
+This step is optional.
+
+Now that you have a working PsychOS system, you can set up users.
+
+### superuser
+Superuser is the most powerful user on the system, and should have a strong password.
+
+```
+[superuser@404cf459 /boot]# passwd superuser
+New password for superuser: \*\*\*\*\*\*\*\*
+```
+
+### A non-superuser
+Running as superuser all the time is bad for security, so you should create a user for yourself.
+```
+[superuser@404cf459 /boot]# passwd username
+New password for username: \*\*\*\*\*\*\*\*
+```
+
+Now, if you press ctrl-alt-c, it should bring up a login screen.
+
+Congratulations, you now have a functional and configured PsychOS system.