cross building

if you are building from another OS you will first have to make a cross toolchain

required sofware

git
gcc or any c compiler
coreutils
MPC (libmpc-dev)
GMP (libgmp-dev)
MPFR (libmpfr-dev)
bison
flex
texinfo
automake
autoconf (2.72 or change version in the script)
a shell (sh,bash,dash,ksh,…)
make

on ubuntu you can get everything by running

sudo apt install build-essential bison flex texinfo libmpc-dev libgmp-dev libmpfr-dev automake autoconf

cloning

first clone the repo

git clone https://github.com/tayoky/stanix --recurse
cd stanix

building cross toolchain

then you can run the script to build the toolchain

./build-toochain.sh --target=x86_64-stanix

[!NOTE]
do ./build-toolchain.sh --help
for a full list of the options

[!NOTE]
supported values for --target are x86_64-stanix, i386-stanix and aarch64-stanix

[!NOTE] compiling the toolchain (that contain gcc) might takes some time

now source the script to setup the PATH, CC, … variables

. ./add-to-path.sh

[!NOTE]
you will have to do this step every time you quit your sessions and come back (or open/close a new terminal window)
once you have done this step the default C compiler for this session is a stanix cross compiler use unset CC to revert to your system compiler

then you can follow the guide same as self building

self building

if you are compiling from stanix (or using the cross toolchain) follow these steps

required software

git
gcc ld ar and as (tcc might also work but is untested)
make
nasm
coreutil
gdisk (for hdd images)
mtools (for hdd imaages)
xorriso (for iso images)
pkg-config

configure

first configure, this will detect the compiler and linker

./configure --host=x86_64-stanix

[!NOTE]
supported values for --host are x86_64-stanix, i386-stanix and aarch64-stanix

see configuration options for all supported options

compiling

first run make and then just run make all for all images or

make hdd for hdd image
make iso for iso image make test create an hdd image and automaticly launch it with qemu

configuration options

all options supported by the ./configure script

--host=XXX precise the host for finding the compiler this should always be x86_64-stanix or not present
--sysroot=XXX custom sysroot path
--cc=XXX use a custom c compiler
--ld=XXX use a custom linker
--nasm=XXX use a custom assembler (must use the intel syntax and produce 64-bit objects files)

installing programs

for the moment, any program you want to install must be put into ./initrd/bin/ in the repo
then redo make all

you can install port by going into the ports folder then running ./build.sh XXX and ./install.sh XXX exemple with doom :

cd ports
./build.sh doomgeneric
./install.sh doomgeneric

a list of ports is available here