Getting Started

Installation & Setup

In the default CC shell run

wget run https://raw.githubusercontent.com/Platratio34/peterOS/master/networkInstaller.lua

It will probably error, if so reboot the computer and run

osUpdate y

and enter root as the password

Super User

PeterOS has a user-like system that means that certain actions, like installing programs, require being the super user to do. The default password for the super user is root and can be changed with password

There are 2 ways to do an action as the super user: sudo and su. It is recommended to use sudo over su so that only actions that need it are run with the super user permissions.

sudo

sudo [program] [arguments...]

Stands for: super user do. It allows you to run another program as the super user, but does not keep you logged in as the super user.

su

Allows you to log in as the super user and do actions as it. Use logout to logout when you are done with the actions

password

Allows you to change the super user password, requires you to enter the current password.

File system tree

PeterOS uses a unix like file system tree. This means that most of you personal files will be under /home/ rather than in the computer root.

Startup scripts

Any file under /home/startup/ will be run whenever the computer starts. This can be used to automatically mount FTP connections, or similar actions.

OS files

Any file in the root directory of the computer or under /os/ are part of the operating system, and therefore can not be edited without super user permissions. Programs are installed under /os/bin/[programName]/ by pgm-get, and /os/lib/ contains several useful libraries that can be gotten in lua with pos.require(path).

Programs

pgm-get

Program-get is the default program installation program, and can be used to install and update all of the programs I have created for the operating system. Installing programs requires you to be logged in as the super user using either sudo or su. Specific information can be found on the pgm-get Github repository.

osUpdate

OS Update allows you to update the operating system version. Pass y as the first argument to skip the overwrite prompt.