OC-PsychOS/docs/install.md

# 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
```

If you are unable to donload the file, try http rather than https.
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>/`  
You can also use /tmp/ if you want a full live system. At present this uses about 50k out of the 64k available on /tmp/

```
[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.

If the machine hangs, use the http version of the recipe file:

```
http://oc.shadowkat.net/PsychOS/build/fsdev/PsychOS-fsdev-latest/psychos-latest-http.pkr
```

Once that has completed, power your machine off and take out all but the disk you installed PsychOS onto, then boot it up.

## Step 3: 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.