Skip to main content

Portage update helper scripts.

Project description

Easier Gentoo system maintenance

This is a set of commands to simplify maintaining a Gentoo system.


This command needs eix installed to fully function. It runs eix-sync. This is intended for use as a cron job. I use it daily.

This command can run layman -S for you if you pass -l or --run-layman.


This command will do the following:

  • Update Portage
  • Update @world with options --with-bdeps=y, --update, --deep, --newuse
  • Update live installations of packages (@live-rebuild)
  • Run emerge @preserved-rebuild
  • Run systemctl daemon-reexec (if applicable)
  • Update the kernel

There are flags to disable most parts of this functionality, such as --no-upgrade-kernel. Pass --help to see all the options.

Automatic kernel update process

The automatic kernel update will only work if there are 2 kernels displayed with the command eselect --brief kernel list. The first one in the list must be the active kernel. The second one is the one to upgrade to. After switching to the new kernel, a .config must exist in /usr/src/linux or the command will not run make. If the configuration exists at /proc/config.gz it will be used.

If emerges fails to build the kernel because of the state of eselect kernel list, you can fix it and re-run the update by running upgrade-kernel.

The old kernel data in /boot will be stored in /root/.upkeep/old-kernels.

Only GRUB (grub-mkconfig) and Dracut are supported for the kernel update. There is currently no way to skip Dracut or GRUB. Valid configurations must be present in /etc.

If you want to only rebuild the kernel, run rebuild-kernel.


This command will run the following commands (or equivalents):

  • emerge --depclean
  • emerge @preserved-rebuild
  • revdep-rebuild
  • eclean-dist --deep
  • rm -fR /var/tmp/portage/*

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for upkeep, version 1.2.7
Filename, size File type Python version Upload date Hashes
Filename, size upkeep-1.2.7.tar.gz (5.8 kB) File type Source Python version None Upload date Hashes View
Filename, size upkeep-1.2.7-py3-none-any.whl (5.3 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page