The unstable software collection (aka repository) contains the latest changes and features that will be coming in the next stable version of carbonOS. However, as the name suggests, this collection comes with no stability guarantees. Proceed at your own risk. If you’re interested in the latest and greatest upcoming features, you can test them here and your feedback will help find and fix bugs before they can make their way into a stable release.
To prevent accidental activation of this unstable collection, carbonOS does not
include the necessary configuration to just enable it with
setup is required first. Follow these steps:
pkexec and typing
in your credentials at the prompt
curl https://repo.carbon.sh/remote-unstable.conf > /etc/ostree/remotes.d/carbon-unstable.conf.
This downloads and installs a configuration file that adds the unstable repository
to the system’s list of collections
curl https://repo.carbon.sh/gpg/unstable.gpg | ostree remote gpg-import carbon-unstable --stdin.
This downloads and trusts the GPG key that is used to verify the integrity of
the releases in the unstable collection
exit to leave the root shell
updatectl switch --collection sh.carbon.Unstable to download and deploy
the latest unstable version
The unstable collection uses a “rolling” release model, with updates being published approximately daily. I highly recommend making sure that you keep the system no more than a few days out of date
If you’d like to revert back to the stable carbonOS repository, please note that you will be downgrading software versions, which always runs the risk of file format incompatibilities (i.e. a newer version of a program generated a new file format that an older version of the same program cannot handle). I suggest switching back to the stable repository only once the version you’ve been testing is released to the stable branch.
To switch back to the stable repository, just run
updatectl switch --collection sh.carbon.Stable and reboot.
If you’re interested in testing unstable releases of carbonOS, you may also
want to test unstable releases of your apps. To enable beta versions in the
Software app, open a terminal and run this command:
flatpak remote-add flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo.
You should now be able to select the
flathub-beta source in the Software app
to install beta versions of your software.