Guide: Switch to new repo (rolling unstable)

[NomadicCore]

Hi all,

I have written up a short post on how to migrate over to the new repo for anyone eager to make the transition.

Scripted migration to the new unstable repository

Open a terminal emulator like GNOME terminal or similar, and run the following one-liner:

curl -fsS https://raw.githubusercontent.com/AerynOS/recipes/refs/heads/2025-05-repo-rebuild/m/moss/pkg/moss-update-repos.bash | sudo bash -

Example output:

❯ curl -fsS https://raw.githubusercontent.com/AerynOS/recipes/refs/heads/2025-05-repo-rebuild/m/moss/pkg/moss-update-repos.bash | sudo bash -
[sudo: authenticate] Password: 
The following package(s) will be installed:

yq  4.44.6-5   

Installed yq

71449 entries blitted in 0.87s (82.2k / s)

Currently known moss repositories:

 - volatile = https://packages.aerynos.com/volatile/x86_64/stone.index [0]

Found /etc/moss/repo.d/volatile.yaml:
 - volatile = https://packages.aerynos.com/volatile/x86_64/stone.index [0]
Removing outdated volatile repository ...
volatile removed
Adding current volatile repository (disabling by default) ...
volatile added
volatile disabled
Adding current unstable repository (enabling by default) ...
unstable added
unstable enabled

Updated list of known moss repositories:

 - unstable = https://cdn.aerynos.dev/unstable/x86_64/stone.index [0]
 - volatile = https://build.aerynos.dev/volatile/x86_64/stone.index [10] (disabled)

If the automated script worked as intended, please follow the instructions in the following link to begin using our new pkgsets:

Guide: Update to new pkgsets (breaking change)

If the automated script did not work as you expected, you can find instructions for how to manually update to the new unstable repo in the section below.

Steps to manually migrate to the new unstable repository

For those of you who wish to use AerynOS without doing any packaging work, this guide will serve as a manual way for you to update your system to point to the new AerynOS CDN accelerated repo.

Step 1: Sync your system to the latest package versions available

sudo moss sync -u

If there are any updates available, press y to confirm the update and wait for the process to finish.

Step 2: Check what repos you're currently using

moss repo list

First, list what repo(s) you are currently using on your system. Depending on when you originally installed either SerpentOS or AerynOS, you will likely have one of the following repos:

❯ moss repo list
 - volatile = https://dev.serpentos.com/volatile/x86_64/stone.index [0]
 - unstable = https://dev.serpentos.com/volatile/x86_64/stone.index [0]
 - unstable = https://packages.aerynos.com/volatile/x86_64/stone.index [0]
 - unstable = https://aerynos.dev/volatile/x86_64/stone.index [0]

If you have more than one repo, you will have added this yourself at some point, likely for packaging purposes.

Step 3: Add the new repo

sudo moss repo add unstable https://cdn.aerynos.dev/unstable/x86_64/stone.index -p 0

Some points to note:

• This command tells moss to add a repo called unstable with the provided URL with a priority of 0.
• If you already have a repo called "unstable" then this command will replace that old repo with the new one you have just entered

Step 4: Validate your repo list again

moss repo list

The output you're looking for is:

❯ moss repo list
 - unstable = https://cdn.aerynos.dev/unstable/x86_64/stone.index [0]

If you have the correct output, you then want to sync to the repo to upgrade to the latest packages by following this guide:

Guide: Update to new pkgsets (breaking change)

Step 5: If you have multiple repos (or your repo was not called unstable)

If you want to continue packaging work, you can ignore the following steps as we have a separate guide on how to set up your repo list in our Github Discussions.

If however you do not plan on doing any packaging work and you have multiple repos (including if your original repo was not called unstable), you can remove any additional repos you have in your repo list. You will do this by using the following command:

sudo moss repo remove "name"

Replace the name with whatever the name is in your repo list

By way of example, if your original repo was called volatile, the command would be:

sudo moss repo remove volatile

Once you have removed your additional repos, make sure you follow the guide:

Guide: Update to new pkgsets (breaking change)

That should be all that there is to it. If you have any challenges or issues, please reach out with your questions under this post. Please provide the output you have from moss repo list to help us diagnose the issue in one go.

[Vanco]

Is it possible to switch to the new repo when installing AerynOS for the first time using AerynOS-2025.03-GNOME-x86_64.iso?

[ermo]

Sadly no.

We are working on our ISO scripts and will put out a new official ISO "soon".