Sortix 1.1dev nightly manual
This manual documents Sortix 1.1dev nightly, a development build that has not been officially released. You can instead view this document in the latest official manual.
operating system installation instructions
upgrade(7) manual page covers upgrading an existing installation.Before installing any operating system, be sure to have backed up local data in the event something goes wrong. This operating system comes without any warranty at all (see the license).Consider the partitioning scheme and whether you wish to dual boot. Consult the partitioning instructions below. If dual-booting and there isn't enough unpartitioned space, use the native partition editor of the existing operating system to shrink its installation.Determine how the target machine will boot the release. If the firmware supports usb-iso hybrid images, you can use dd(1) or such to copy the release physically onto a USB portable storage device. If the target machine has a cdrom drive, you can burn the release to a cdrom. Insert the installation medium in the computer and power it on. If needed, change the boot order in the firmware to prefer the installation medium over any existing operating system installations.After the installation is complete, remove the installation medium and restore the firmware boot order to prioritize the local harddisk. Then power the computer on normally to run the new operating system.After the installation is complete, power off the computer and remove the -cdrom sortix.iso option.Each of these options are a live environment running exclusively in RAM. The difference is only what program is run after the system has booted. The bootloader will load the whole operating system and ports into memory from the installation medium. This may take a moment. You need enough memory to store the whole system and the runtime usage. If the system memory is really insufficient, then the bootloader may have strange behavior, take a really long time to load, or not complete the boot at all.You can configure which ports gets loaded using the bootloader menu. The base system is rather lean and can be made quite small. You need some ports to complete an installation.The installer will copy the live environment into the target root filesystem according to the file lists in /tix/manifest and create configuration files matching your earlier choices. It will write 256 bytes of randomness to /boot/random.seed. It will generate an initrd that locates and boots the root filesystem. It will install the bootloader if desired. The installation will take a moment.You will be given the choice between powering off the system, rebooting it, or directly booting the new system. The last option will directly boot the new system in a chroot while the live environment remains in the background. If you invoked sysinstall(8) yourself, then you will be returned to your live environment shell. Otherwise the computer will power off when the chroot environment terminates.Upon boot of the new system it will be configured in multi-user mode and you will be presented with a login screen. Authenticate as one of the local users and you will be given a shell. To power off the computer login as user poweroff and to reboot the computer login as user reboot.The user-guide(7) manual page is a basic overview of the system for new users.Congratulations on your new Sortix system.
- A sortix-x.y-arch.iso release for your architecture.
- A cdrom onto which the release has been burned, or USB portable storage onto which the release has been placed at the first byte and onwards.
- A computer meeting the system requirements.
- 32-bit x86 CPU with SSE (i686 release), or 64-bit x86 CPU (x86_64 release).
- 1 GiB RAM (recommended) to run iso live environment (including installer) with all ports loaded, or significantly less if unimportant ports are not loaded. An installation on a harddisk will require very little RAM to run after installation.
- ATA or AHCI harddisk with at least 1 GiB of unpartitioned space.
- BIOS firmware, or UEFI firmware in legacy mode.
- PS/2 keyboard/mouse firmware emulation to use those devices.
- If you wish to dual boot, you need an existing operating system with a multiboot compliant bootloader such as GRUB.
qemu-img create sortix.raw 1G qemu-system-x86_64 -enable-kvm -m 1024 -vga std -cdrom sortix.iso \ -drive file=sortix.raw,format=raw
- Running a fully-featured temporary live environment.
- Running the operating system installer (sysinstall(8)).
- Upgrading an existing installation to this release (sysupgrade(8)).
sysinstall(8) command.The installer is an interactive command line program that asks you questions and you answer them. It provides useful information you shouldn't accidentally overlook. Before answering any question, read all output since your last answer.You should have this installation guide ready at all times. You can view this installation(7) page during the installation by answering '!man' to any regular prompt (excluding password prompts). Likewise you can answer '!' to get an interactive shell. Upon completion, you will be asked the question again.
chvideomode(1). The display will then use this resolution and your preference will be stored in videomode(5).
kernel(7) is a multiboot compatible binary that can be loaded by any multiboot specification compatible bootloader such as GRUB. You need to use such a bootloader to boot the operating system. You will be offered the choice of installing GRUB as the bootloader. Note however that this GRUB is not able to detect other operating systems and you will have to configure it manually if you wish to use it in a dual boot scheme. The answer will default to yes if no existing partitions are found, or if an existing Sortix installation is found that uses the provided bootloader; and will otherwise default to no.The bootloader will be installed on the boot harddisk, which is the harddisk containing the /boot partition if any, and otherwise the harddisk containing the root filesystem.Single-boot configurations should use the offered bootloader. Dual-boot configurations should refuse it and arrange for bootloading by other means. The installer will generate /etc/grub.d/10_sortix.cache which is a fragment of GRUB configuration that offers the menu option of running Sortix. You can splice that into /etc/grub.d/40_custom of an existing GRUB installation and run update-grub(8) to add it as a boot option.If you accept the bootloader, you will be asked if you wish to password protect the bootloader. If you don't, anyone able to use the keyboard during system bootloading will be trivially able to gain root access using the bootloader command line. If you use this, you should also password protect the firmware and prohibit it from booting from anything but the harddisk. An attacker will then need to tamper with the computer itself physically. The password will be hashed and stored in grubpw(5) and is inserted into the GRUB configuration when update-grub(8) is run.
disked(8) partitioning program. You can view its man page by typing man and you can view this man page by typing man 7 installation.disked defaults to the first detected harddisk as the current harddisk. You can switch to another harddisk using the device device-name command. You can view all devices with the devices command.If the current device does not already have a partition table, you can create a mbr(7) or gpt(7) partition table using the mktable command. gpt(7) is the preferred choice for new partition tables as mbr(7) has unfortunate limitations. If you are dissatisfied with the current partition table, you can use the rmtable command which will destroy the partition table and effectively delete all data on the harddisk.The ls command lists all partitions and unused space on the current device. The mkpart command creates a partition. You will be asked interactive questions to determine its location. You will be asked if you wish to format a filesystem. ext2 is the native filesystem. If applicable, you will be asked if you wish to create a mountpoint for it in fstab(5). The rmpart partition-number command removes a partition table entry and effectively deletes all data on the partition.If you accepted the included bootloader, it will be installed on the boot harddisk, which is the harddisk containing the /boot partition if any, and otherwise the harddisk containing the root filesystem. If the boot harddisk uses the gpt(7) partitioning scheme, then you must create a biosboot partition on the boot harddisk which is where the bootloader will be installed. It should be at the start of the boot harddisk and a size of 1 MiB will be more than sufficient.You need to make a partition containing the root filesystem mounted at /. A size of 1 GiB will be comfortable for the base system and ports and basic usage. There is no inherent need for a /boot or a /home partition, so you are encouraged to make the root filesystem as large as you wish. Operating systems upgrades will preserve the root filesystem and the installer handles installing on top of an existing installation and preserves user files and local configuration.Type exit when you are done to continue the installation. If the installer detects a problem with your partitioning, it will offer to run disked(8) again.
hostname(5). This question is skipped if the file already exits.
passwd(5) and group(5). This question is skipped if the root account already exists.
no when you are done. Otherwise enter the name of the new account. If you wish to create an account by the name ofYou will then be asked for the full name and the password for the new user. A user directory will be made in /home. The new user is added to passwd(5) and group(5).Please note that Sortix is not currently secure as a multi-user system and filesystem permissions are not enforced.
nothen simply add a space in front as leading spaces are trimmed.