Skip to content
AerynOS Docs

Updating an existing package recipe

This page details the process of updating a package that is already present in the AerynOS repository.

Before updating the package yourself, please double check that there isn’t already an outstanding PR for the update you want to make. Please also check if someone has created an update request issue in the AerynOS recipes repository.

Update your clone of the recipes repository

Please refer to the Basic Packaging Workflow on how to create and update your local clone of the AerynOS repository on your own system before proceeding any further.

As a reminder, you want to ensure you have the volatile repository enabled and fully updated on your system.

For a recap, if you have followed the previous guide, the commands will be:

sudo moss repo enable volatile
sudo moss sync -u
gotoaosrepo
git switch 2025-05-repo-rebuild
gh repo sync yourusername/yourfork -b 2025-05-repo-rebuild
git pull

Change yourusername to your github username and yourfork to the name you selected for your fork of the AerynOS repository. By default the fork is called recipes.

Switch to a new git branch

When conducting any packaging work, it is a good idea to separate out your work in a different branch. This allows you to isolate changes you make from one package in a separate branch to changes you make to a different package in a second branch and so on. This additionally is helpful as it keeps your work separate to any underlaying changes made to the main recipes repository, more easily allowing you to rebase your work if needed.

git checkout -b update_packagename

Change “update_packagename” to whatever description you feel comfortable with.

You can check what branch you are on and what branches you have in your repository with the following command:

git branch -a

Simple updates to a package

To update a package to a newer available version, navigate to the relevant folder within your local recipe repository on your system. If you have already navigated to the local recipe repository, then by way of example, to navigate to the nano package folder, you would use the command:

chpkg nano

Bumping a package

If there are changes to dependencies of a package, but not to the package tiself, you need to increase the release number within the stone.yaml recipe file by one. This will allow you to rebuild the package and test it against the newer dependences to make sure everything is working. You can do this by using the following command:

just bump

which is a shortcut for

boulder recipe bump

Please note each time you do this, you will increase the release number by one, so do not use this command multiple times for one package update.

Updating a package version

If you need to update the package version itself, you can use the following command:

boulder recipe update --ver "version name" --upstream "upstream URL" stone.yaml -w

In the example of nano, to update to version 8.5, you would use the following command:

boulder recipe update --ver 8.5 --upstream https://www.nano-editor.org/dist/v8/nano-8.5.tar.xz stone.yaml -w

This command does the following:

  1. Updates the version of the package within the recipe
  2. Updates the upstream location of the source code
  3. Checks the Sha256sum of the source code and inputs this in the recipes
  4. Bumps the release number by 1

Wider updates to a package

If there are missing dependencies or you need to make further changes to the stone.yaml recipe file, you can either use nano to make changes to the stone.yaml from within your terminal or you can use a code editor such as zed which is pre-installed on AerynOS. Guidance on how to make changes to a stone.yaml file are covered in the Create a new package recipe page.

Build the package

Once you have made the relevant changes to the package, you will need to build it locally. Please ensure you have followed the steps above to enable the volatile repository. If you are only updating one package, you can either keep your local repository disabled prior to building the package, or if you prefer to keep it enabled, make sure there are no other packages indexed locally that could interfere with your new package build.

The command to build the updated package is:

just build

If the package is successfully built, you will need to move it to your local repository. You can do this using the following command:

just mv-local

If you have not yet enabled the local repository, you do this with the following command:

sudo moss repo enable local

You will then need to sync the local repository using the command:

sudo moss sync -u

Note, if you already have an older version of the package installed, you will be asked if you want to update to the new local version you have just built. If you have not yet installed this package, you would install it as normal using the command:

sudo moss install "package name"

Once you have tested the package, you can make a submission for including the update in the repository.