Download

Tedaryum — Wed, 03 Jun 2026 08:20:11 GMT

Vagrant

← Older revision		Revision as of 08:20, 3 June 2026
(4 intermediate revisions by the same user not shown)
Line 29:		Line 29:
	To use it in a new project;		To use it in a new project;

	vagrant init onixos~~/core~~		vagrant init olproject/onixos --box-version 3.0
	~~vagrant up~~

	To use it in the Vagrantfile file;		To use it in the Vagrantfile file;

	Vagrant.configure("2") do \|config\|		Vagrant.configure("2") do \|config\|
	config.vm.box = "onixos~~/core~~"		config.vm.box = "olproject/onixos"
			config.vm.box_version = "3.0"
			config.ssh.username = "vagrant"
			config.ssh.password = "vagrant"
			config.ssh.insert_key = true
	end		end

	=== Arch Linux Mirrors ===		=== Arch Linux Mirrors ===

User:MediaWiki default

Tedaryum — Wed, 03 Jun 2026 05:48:24 GMT

Tedaryum blocked MediaWiki default with an expiration time of indefinite (account creation disabled)

Forum

Tedaryum — Sun, 31 May 2026 09:49:16 GMT

← Older revision		Revision as of 09:49, 31 May 2026
Line 1:		Line 1:
	The official community forum for the Onix Project, where users can engage in discussions, share feedback, and access support resources, can be found at https://forum.onix-project.com/.		The official community forum for the Onix Project, where users can engage in discussions, share feedback, and access support resources, can be found at https://forum.onix-project.com/.

			Telegram channel: http://t.me/onixos_community

Main Page

Tedaryum — Fri, 08 May 2026 11:02:14 GMT

@@ Line 1: / Line 1: @@
-=== '''Welcome to The OnixOS Main Page.''' ===
+= OnixOS =
-* [[Download]]
+[[File:OnixOS.png|thumb|right|OnixOS Logo]]
-===== Sources: =====
+'''OnixOS''' is an open-source, Arch Linux-based distribution. It ships with '''O Language''' — a system-level functional programming language developed specifically for OnixOS — and offers a curated set of developer tools.
-* [https://sourceforge.net/projects/onixos Sourceforge]
+__TOC__
-* [https://gitlab.com/onix-os Gitlab - OnixOS]
-* [https://gitlab.com/olanguage/ Gitlab - O Language]
+== About ==

OnixOS:Building From Scratch

Tedaryum — Fri, 08 May 2026 10:57:25 GMT

Created page with "= Building OnixOS = This document covers the complete build lifecycle of the OnixOS Build System — from environment setup and package repository builds to ISO creation, syncing, Docker-based builds, and live build monitoring. __TOC__ == Prerequisites == The build system runs on '''Arch Linux''' (or an Arch-based environment). The following packages are required for ISO builds and are installed automatically by <code>build.py</code>: {| class="wikitable" ! Package..."

New page

= Building OnixOS =

This document covers the complete build lifecycle of the OnixOS Build System — from environment setup and package repository builds to ISO creation, syncing, Docker-based builds, and live build monitoring.

__TOC__

== Prerequisites ==

The build system runs on '''Arch Linux''' (or an Arch-based environment). The following packages are required for ISO builds and are installed automatically by <code>build.py</code>:

{| class="wikitable"
! Package !! Purpose
|-
| <code>archiso</code> || Core ISO creation tool (<code>mkarchiso</code>)
|-
| <code>base-devel</code> || Compiler toolchain
|-
| <code>arch-install-scripts</code> || <code>pacstrap</code>, <code>arch-chroot</code>
|-
| <code>squashfs-tools</code> || SquashFS filesystem creation
|-
| <code>dosfstools</code> || FAT filesystem creation
|-
| <code>syslinux</code> || Bootloader
|-
| <code>git</code> / <code>git-lfs</code> || Source fetching
|-
| <code>rsync</code> || File synchronisation
|-
| <code>go</code> || Go language toolchain
|-
| <code>nasm</code> || Assembler
|-
| <code>ninja</code> || Build system
|-
| <code>gperf</code> || Hash function generator
|-
| <code>imagemagick</code> || Image processing
|-
| <code>python-sphinx</code> / <code>xmlto</code> || Documentation toolchain
|-
| <code>gnome-shell</code> / <code>qtcreator</code> || Desktop environment build deps
|-
| <code>sudo</code> || Privilege escalation
|}

For '''repository builds''' the system additionally uses <code>makepkg</code> (included in <code>base-devel</code>) and the AUR snapshot endpoint:

https://aur.archlinux.org/cgit/aur.git/snapshot

== Project Structure ==

<pre>
onix-build-system/
├── build.py # Main build entry point
├── clean.py # Cleans output/ and mounts
├── watcher.py # Terminal build status monitor
├── qemu.py # Launch built ISO in QEMU
├── Makefile # Convenience make targets
├── Dockerfile # Build container image
├── entrypoint.sh # Docker entrypoint
├── docker-compose.yml # Dev shell container
├── docker-compose.iso.yml # Automated ISO build container
├── docker-compose.repos.yml # Automated repo build container
├── onixos/
│ ├── iso.py # ISO build logic (mkarchiso wrapper)
│ ├── pkgbuild.py # PKGBUILD / .SRCINFO parser
│ ├── proc.py # Subprocess wrapper with logging
│ └── repository.py # Repository build logic
├── sources/
│ ├── packages/ # Local package sources (PKGBUILD)
│ ├── profiles/ # archiso profiles (core, gnome, xfce, icewm, security)
│ ├── packages.list # Local packages to build
│ ├── aur.list # AUR packages to build
│ ├── profiles.list # ISO profiles to build
│ ├── sync/ # Repo upload config
│ │ ├── sourceforge.conf
│ │ └── local.conf
│ └── isosync/ # ISO upload config
│ ├── sourceforge.conf
│ └── local.conf
├── output/ # All build artefacts (generated)
└── logs/ # Build logs (generated)
</pre>

== Build Commands ==

All commands must be run from the '''repository root'''.

=== Full Build ===

Builds all repositories '''and''' all ISO profiles in sequence:

sudo python build.py

=== Repository Build ===

Builds the <code>onix-base</code> (local packages) and <code>onix-aur</code> (AUR packages) repositories:

python build.py repos

The build process:
# Installs build dependencies via <code>pacman</code>.
# Builds local packages listed in <code>sources/packages.list</code> and generates the <code>onix-base</code> repo under <code>output/base/</code>.
# Downloads AUR snapshots for packages listed in <code>sources/aur.list</code>, builds them, and generates the <code>onix-aur</code> repo under <code>output/aur/</code>.

=== ISO Build ===

Builds an ISO image for every profile listed in <code>sources/profiles.list</code>:

sudo python build.py iso

The build process per profile:
# Installs ISO build dependencies via <code>pacman</code>.
# Unmounts any stale mounts from a previous failed build inside the work directory.
# Cleans the work directory (<code>output/iso/<profile>/work</code>).
# Runs <code>mkarchiso</code> with the matching profile under <code>sources/profiles/<profile>/</code>.
# Writes the finished <code>.iso</code> file to <code>output/iso/<profile>/output/</code>.

The underlying <code>mkarchiso</code> command:

<pre>
sudo mkarchiso -C "sources/profiles/<profile>/pacman.conf" \
-v \
-w "output/iso/<profile>/work/" \
-o "output/iso/<profile>/output" \
-L "ONIXOS" \
"sources/profiles/<profile>"
</pre>

=== Upload / Sync ===

Uploads built repositories to the configured remote server(s):

python build.py upload

Uploads built ISO images:

python build.py iso-sync

Both commands read from the relevant <code>*.conf</code> files under <code>sources/sync/</code> and <code>sources/isosync/</code> respectively (see [[#Sync Configuration|Sync Configuration]]).

== Make Targets ==

<pre>
make # clean → repos → iso (full build)
make clean # Remove output artefacts and unmount
make repos # Repository build only
make iso # ISO build only

make docker_build # Build the Docker image
make docker_publish # Push image to registry (olproject/buildkit)
make docker_pull # Pull image from registry
make docker_shell # Open interactive shell in container

make docker_iso_build # Run ISO build inside Docker, copy output locally
make docker_repo_build # Run repo build inside Docker, copy output locally
</pre>

== Docker Builds ==

The Docker image is based on <code>archlinux</code> and ships with all build dependencies pre-installed. The image tag is <code>olproject/buildkit</code>.

=== Building the Image ===

<pre>
docker build . -t olproject/buildkit
# or via make:
make docker_build
</pre>

=== ISO Build via Docker ===

<pre>
docker-compose -f docker-compose.iso.yml up --abort-on-container-exit --build
docker cp buildkit:/home/buildkit/builder/output/. ./output/
docker cp buildkit:/home/buildkit/builder/logs/. ./logs/
docker rm buildkit
# or via make:
make docker_iso_build
</pre>

=== Repository Build via Docker ===

<pre>
docker-compose -f docker-compose.repos.yml up --abort-on-container-exit --build
docker cp buildkit:/home/buildkit/builder/output/. ./output/
docker cp buildkit:/home/buildkit/builder/logs/. ./logs/
docker rm buildkit
# or via make:
make docker_repo_build
</pre>

=== Interactive Shell ===

Starts a persistent container with output and logs mounted as volumes, useful for manual inspection or debugging:

<pre>
docker-compose up -d
docker exec -it buildkit bash
# or via make:
make docker_shell
</pre>

The container mounts:
* <code>./output/</code> → <code>/home/buildkit/builder/output</code>
* <code>./logs/</code> → <code>/home/buildkit/builder/logs</code>

{{Note|The container runs in <code>--privileged</code> mode, which is required by <code>mkarchiso</code> for loop device and mount operations.}}

== Profiles ==

ISO profiles are listed in <code>sources/profiles.list</code>, one per line. Each profile corresponds to a directory under <code>sources/profiles/</code> that contains a complete <code>archiso</code> profile (including <code>pacman.conf</code>, <code>packages.x86_64</code>, <code>airootfs/</code>, etc.).

Available profiles:

{| class="wikitable"
! Profile !! Description
|-
| <code>core</code> || Minimal base system
|-
| <code>gnome</code> || GNOME desktop environment
|-
| <code>xfce</code> || Xfce desktop environment
|-
| <code>icewm</code> || IceWM lightweight desktop
|-
| <code>security</code> || Security-focused variant
|}

To build only a specific profile, edit <code>sources/profiles.list</code> temporarily or call <code>ISO.mkarchiso()</code> directly.

== Packages ==

=== Local Packages (onix-base) ===

Defined in <code>sources/packages.list</code>. Sources live under <code>sources/packages/<name>/</code>:

{| class="wikitable"
! Package !! Purpose
|-
| <code>olang</code> || OnixOS language runtime
|-
| <code>onix-base</code> || Base system metapackage
|-
| <code>onix-graphics</code> || Graphics stack
|-
| <code>onix-meta</code> || Meta package
|-
| <code>calamares-onix</code> || Graphical installer
|-
| <code>linux-onix</code> || OnixOS kernel
|-
| <code>plymouth-onix-boot</code> || Boot splash screen
|}

=== AUR Packages (onix-aur) ===

Defined in <code>sources/aur.list</code>. Downloaded from the AUR snapshot endpoint at build time. Output goes to <code>output/aur/</code>.

== Sync Configuration ==

Both repository and ISO sync use SSH (<code>rsync</code> over SSH). Configuration files follow the standard <code>configparser</code> INI format.

=== Repository Sync ===

Config files read by <code>build.py upload</code> (both are used if they exist):
* <code>sources/sync/sourceforge.conf</code> — SourceForge remote
* <code>sources/sync/local.conf</code> — Local/internal server

Example:

<pre>
[sync]
server = frs.sourceforge.net
user = olproject
path = /home/frs/project/onixos/Repo
port = 22
keyfile = /home/ted/.ssh/id_ed25519
</pre>

Uploads <code>output/base/repo</code> → <code><path>/base</code> and <code>output/aur/repo</code> → <code><path>/aur</code>.

=== ISO Sync ===

Config files read by <code>build.py iso-sync</code>:
* <code>sources/isosync/sourceforge.conf</code>
* <code>sources/isosync/local.conf</code>

Uploads <code>output/iso/<profile>/output</code> → <code><path>/ISO</code> for each profile.

== Debug Mode ==

Append <code>-d</code> to <code>iso</code> or <code>repos</code> subcommands to stream <code>stdout</code>/<code>stderr</code> to the terminal in real time:

<pre>
sudo python build.py iso -d
python build.py repos -d
</pre>

Without <code>-d</code>, command output is only written to the log files in <code>logs/</code>.

== Build Watcher ==

<code>watcher.py</code> provides a live terminal dashboard that tracks ISO and repository build status, active mounts, and recent log output. It refreshes every 3 seconds.

'''Standalone (curses UI):'''

python watcher.py

Press <code>q</code> or <code>Esc</code> to exit.

'''Attached to a build (GUI overlay):'''

<pre>
sudo python build.py iso -gui
python build.py repos -gui
</pre>

The <code>-gui</code> flag starts the watcher in a background thread alongside the build process and stops it automatically when the build finishes.

'''What the watcher shows:'''
* '''ISO Builds''' — profile name, ISO filename, file size, build timestamp, and status.
* '''Repositories''' — repo name, package count, DB update timestamp, and status.
* '''Active Mounts''' — any loop/overlay mounts still active inside <code>output/</code>.
* '''Last Build Log''' — last 6 lines of <code>logs/isobuild.log</code> with colour-coded errors and warnings.

== Testing with QEMU ==

Launch a built ISO in a QEMU virtual machine for quick validation:

python qemu.py <path-to-iso>

Example:

python qemu.py output/iso/gnome/output/onixos-gnome-x86_64.iso

VM parameters (hardcoded defaults):

{| class="wikitable"
! Parameter !! Value
|-
| RAM || 4 GB
|-
| CPU || x86_64
|-
| Cores || 1
|-
| VGA || qxl
|-
| Network || User-mode (NAT)
|-
| Boot || CD-ROM
|}

<code>qemu-system-x86_64</code> must be installed and available in <code>PATH</code>.

== Cleaning the Build ==

Removes all build artefacts, clears the pacman package cache, unmounts any stale mounts, and deletes log files:

<pre>
sudo python clean.py
# or via make:
make clean
</pre>

What <code>clean.py</code> does in order:
# Reads <code>/proc/mounts</code> and unmounts (with <code>umount -l</code>) anything mounted inside <code>output/</code>, deepest paths first.
# Clears the pacman package cache: <code>find /var/cache/pacman/pkg/ -name '*.pkg.tar.*' -delete</code>.
# Removes all <code>logs/*.log</code> files.
# Removes all contents of <code>output/</code> with <code>sudo rm -rfv output/*</code>.

{{Warning|This is destructive. All previously built ISOs and repository packages will be deleted.}}

== Output Structure ==

After a successful full build:

<pre>
output/
├── base/
│ └── repo/ # onix-base repository (.pkg.tar.zst, .db, .files)
├── aur/
│ └── repo/ # onix-aur repository
└── iso/
├── core/
│ ├── work/ # mkarchiso working directory (temporary)
│ └── output/ # core-*.iso
├── gnome/
│ ├── work/
│ └── output/ # gnome-*.iso
├── xfce/
├── icewm/
└── security/
</pre>

== Logs ==

Build logs are written to <code>logs/</code> in the repository root:

{| class="wikitable"
! Log file !! Contents
|-
| <code>logs/isobuild.log</code> || <code>mkarchiso</code> command output, timestamps, exit codes
|-
| <code>logs/pacinst.log</code> || <code>pacman</code> dependency installation output
|-
| <code>logs/clean.log</code> || Clean operation output
|}

Each log entry records the command, date/time, exit code, stderr, and stdout.

Documentation

Tedaryum — Fri, 08 May 2026 10:50:59 GMT

← Older revision		Revision as of 10:50, 8 May 2026
Line 5:		Line 5:
	* [[OnixOS:Package Management\|Package Management]]		* [[OnixOS:Package Management\|Package Management]]
	* [[OnixOS:Repositories\|Repositories]]		* [[OnixOS:Repositories\|Repositories]]
			* [[OnixOS:Building From Scratch\|Building From Scratch]]