Skip to content

Getting Started

Peter edited this page Mar 19, 2024 · 6 revisions

Installation

To install PeterOS, run the following command in the computer craft shell and follow the onscreen prompts:

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

If it errors, ie. if red text appears on the screen and the last line in the shell you see is >, then reboot the computer and run:

osUpdate y

When prompted for a password, enter root and press enter.

The operating system should not be installed. If it has, it should say:

Starting PeterOS
Finished Loading PeterOS Vx.x

home>

If not, consult the FAQ for help solving the error on screen.

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 To run an action as the super user use sudo.

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 & logout

If you are going to need to run a bunch of actions as the super user, you can user su to switch the super user, then logout when you are done.

It is recommended to use sudo when possible as it limits accidents when doing things as the super user.

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

osUpdate [y] [-v version]

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

Clone this wiki locally