Sortix
Sortix Download Manual Development Source Code News Blog More
current nightly

NAME

upgrade.conf — upgrade configuration

SYNOPSIS

/etc/upgrade.conf

DESCRIPTION

The upgrade.conf controls the actions taken by sysupgrade(8) during a system upgrade as described in upgrade(7). The file allows customizing whether the system itself is replaced, whether new ports are installed, whether the new source code is installed and what happens to the old source code. It also records information about the system such as how the system is booted. The file is created automatically by sysinstall(8) as part of installation(7) to match what was installed.
Developers may wish to customize what happens to /src on a system upgrade. The new source code can be installed or not. If it is installed, it can be installed in /newsrc or by default in /src. Any existing source code will be safely moved inside a subdirectory of /oldsrc.
It is possible to disable any upgrading whatsoever. If you do this, except the new source code is installed, then you can upgrade to the new system manually as described in development(7). Upgrading to the next release from source is not supported.

FORMAT

The file is read line by line. The # character starts a comment and the rest of the line is ignored. Lines are supposed to contain assignments to variables. An assignment is the name of the variable, whitespace, an equal character, whitespace, the value, whitespace, and then the end of the line.
grub=[no | yes] (default no).
States GRUB is used as the bootloader. If either the system or ports are set to yes, then the bootloader is reinstalled (grub-install(8)) and updated (update-grub(8)).
newsrc=[no | yes] (default no).
Place the new source code in /newsrc and move any existing /newsrc into /oldsrc. This preserves the current /src directory. This takes precedence over and disables the behavior described under src.
ports=[no | yes] (default yes).
Install the new ports.
src=[no | yes] (default no).
Place the new source code in /src and move any existing /src into /oldsrc.
system=[no | yes] (default yes).
Install the new system. This will run update-initrd(8) and if grub is set to no, then regenerate /etc/grub.d/10_sortix.cache.
The defaults will be used if /etc/upgrade.conf is missing.

FILES

/etc/upgrade.conf
Upgrade configuration.

EXAMPLES

system = yes 
ports = yes 
src = no 
grub = yes

SEE ALSO

upgrade(7), sysupgrade(8)
Copyright 2011-2025 Jonas 'Sortie' Termansen and contributors.
Sortix's source code is free software under the ISC license.
#sortix on irc.sortix.org
@sortix_org