# PageKey Operating System (PKOS)

PageKey Operating System (PKOS) is a rudimentary computer operating system developed on video. The process of researching and developing the operating system is documented as extensively as possible in videos, articles, and notes for educational purposes.

## Source Code​

The latest source code can be found at https://github.com/pagekeysolutions/pkos.

## Quick Help​

Try these commands to get started in a hurry.

• docker-compose up - Build and run the OS (added in OS13)
• You must have Docker/docker-compose installed and configured for GUI applications to run within a container.
• Also available:
• scripts/docker_build: (Re)build your Docker dev container with the latest Dockerfile
• scripts/docker_run: Same as docker-compose up - run it now
• scripts/docker_shell: Get a shell inside the docker environment to do as you please
• make - Build the OS
• make run - Run the OS in Qemu, an x86 emulator
• make iso - Build an ISO image of the OS. This file can be burned to a disk or USB drive. Then you can run it on real hardware!

## Troubleshooting​

• If you're getting errors initializing the display when using Docker:
• Try the following if you're on Mac or Linux: xhost local:root
• If you're on Windows, make sure that you have an X11 server installed and running.

Use the "Release Tag" listed below for the video you would like to run the code for. Replace TAG with the actual Release Tag in what's below:
git clone https://github.com/stephengrice/pkoscd pkosgit checkout TAGmakemake run