Shiro - Operating System (OS)

 

How to get started?

If you are using windows, make sure all files are LF instead of CRLF.

You can disable CRLF on Git by doing (optional):

$ git config --global core.safecrlf false
$ git config --global core.autocrlf false

To clone the project:

$ git clone [email protected]:shiro-dev/shiro.git

Requirements

Windows

QEMU emulator version 3.1.50+

Docker version 18.03.0-ce+

Docker Compose version 1.20.1+

Ubuntu (not tested)

QEMU emulator version 2.1.2+

$ apt-get update -y
$ apt-get install -y qemu

Docker

$ sudo apt-get update -y
$ sudo apt-get install docker-ce
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

If you need to set-up docker repository, please refer to docker documentation.

Docker Compose

$ sudo apt-get update -y
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

Build Environment

This command will build the development environment on docker.

$ make docker-build

Run Shiro

This command will build/rebuild the OS on docker and will run it using QEMU.

$ make run

Special Thanks

• OSDev.org
• OSDev Forum
• GNU
• Free Software Foundation
• Philipp Oppermann
• Leo Whitehead
• Hacker Pulp
• Eugene Obrezkov
• Mike Saunders
• Computer Tyme
• Napalm
• Yoshinori K. Okuji
• Bryan Ford
• Erich Stefan Boleyn
• Kunihiro Ishiguro
• Erik Helin
• Adam Renberg
• James Molloy
• Samy Pessé
• Klaykap
• Tu, Do Hoang
• Brandon F.