NAME

install — install rawnix packages onto a target from the network

SYNOPSIS

install --target mountpoint group ...

DESCRIPTION

install downloads pre-built packages from the bulk module on rsync.rawnix.org and installs them with addpkg(8) into the system mounted at mountpoint. It is the netinstaller's own command; on the installer image it replaces install(1), which is why this page is read with man 8 install.

The target must be mounted and prepared with setup-filesystem(8) first. The groups are installed in the order given; the runtime libraries always come first.

base: The whole system: libs, core, opt, the development tools, and the kernel.
core: libs, the base system and opt, without a kernel.
opt: udevd, limine and tinyrd.
libs: libffi, libedit, libucontext and json-c.
kernel: The newest prebuilt kernel. It needs the result of setup-boot(8), a mounted EFI system partition at boot/efi and, for its initramfs, the opt group, so give it last:
# install --target /mnt core kernel

The development tools are only installed as part of base: llvm, rust, gcc-compat, cmake, python3, make, meson, samurai, pkgconf, autoconf, automake, libtool, m4 and perl.

Installing the kernel writes the boot menu on the EFI system partition; see bootloader(7). Later kernels are never installed by pkg sysup; a kernel is only ever installed by hand.

Afterwards install copies /etc/ports/ports.rsync and the trusted keys in /etc/ports/keys/ into the target, so the new system can sync and verify ports.

FILES

/etc/ports/ports.rsync: The rsync token for rsync.rawnix.org.
/etc/ports/keys/*.pub: Trusted signing keys, copied into the target.
mountpoint/tmp/rawnix-install/: Downloads while installing; removed at the end.

EXIT STATUS

install exits 0 when every package was installed. If some were not, it lists them, warns that the target is incomplete, and exits 1. It stops at once if the network or the target is not usable.

EXAMPLES

# install --target /mnt
  base