Our goal is to develop an operation system that focuses on the terminal, performance and reliability. We hope to provide you with a functional, performant and stable OS. And we do that together, everyone can help!
Before you build the project, you need to clone the submodules. To do so, run git submodule update --init --recursive.
To build this OS, you need one of these:
- A 64 bit Ubuntu or Debian based OS so you can install the following packages with apt:
sudo apt install graphicsmagick-imagemagick-compat mtools lbzip2 curl bison flex gcc g++ unzip dosfstools automake build-essential nasm qemu-utils gdisk git. We recommend you runtoolchain.shto build binaries that will be compatible with FoxOS. - WSL (Windows Subsystem for Linux) with Ubuntu installed and the same things as above.
- Our Docker image. You can run it like this:
docker run -it --rm -v /dev:/dev --privileged ghcr.io/theultimatefoxos/foxos-toolchain:latest. An easy way to have this setup would be to open a command line or terminal window at a directory on your host machine with FoxOS cloned and run this:docker run -it --rm -v /dev:/dev --privileged -v $PWD:/root/FoxOS ghcr.io/theultimatefoxos/foxos-toolchain:latestto mount it at/root/FoxOS. - An Intel Mac. You need to make sure to have these commands:
curl,zip/unzip,make,brew, andgcc. First run:brew install mtools,brew install gdisk, and then runtoolchain_mac.sh.
Then simply run one of the following:
make: build the project.make img: package the.imgfile.make mac-img: package the.imgfile on an Intel Mac.make docker-img: package the.imgfile in Docker.make run: To build and run FoxOS. (Will not work on Mac)
The following alias command can be used to make your life easier: alias mkfox="make USER_CFLAGS=\"-DDEBUG -DMEMORY_TRACKING -DBOOTINFO -fsanitize=undefined -DUBSAN_SUPRES_TYPE_MISSMATCH\""
make usb: build a bootable USB. The USB must be formatted with FAT32!make losetup: build a script to be able to runlosetupwithout root permissions.make clean: clear all the built files.make debug: build and debug using deno.make run-dbg: start a screen for QEMU so you can debug usinggdb.make vmdk: build a.vmdkfile.make vdi: build a.vdifile.make qcow2: build a.qcow2file.make vbox-setupsetup a VirtualBox VM (only works on Linux)
Feel free to fix a bug, implement a feature or any other change you think would be good. If you want to contact us, join our Discord, we are there to help with any question you may have. Or you can create an issue. If you don't know what to implement you can take a look at our TODO list.
To run this OS, you can either use a VM or a bootable USB. See the building section for more info on how to build them. How to start:
- QEMU: Use
make runto build and launch QEMU with the correct configuration. - VirtualBox: Use
make qcow2to build a.qcow2image file and create a VM to which you add this.qcow2. Then you need to enable EFI under "System" in your VM's config. Then run it!
If you want to add documentation on running this OS on a different emulator, feel free to do so.
Here is the link to our Discord.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent