Include:Upgrading to Edge
(Redirected from Edge:Upgrading to Edge)
An upgrade of Alpine Linux from a stable version to the rolling development version edge basically requires the same steps as Upgrading to latest release.
There are only two differences:-
- When editing the /etc/apk/repositories file, all referenced repository versions (such as
v3.22
orlatest-stable
) therein need to be pointing toedge
as follows.Contents of /etc/apk/repositories
#/media/cdrom/apks http://dl-cdn.alpinelinux.org/alpine/edge/main http://dl-cdn.alpinelinux.org/alpine/edge/community @testing http://dl-cdn.alpinelinux.org/alpine/edge/testing - When the upgrade completes, edge currently issues an encouragement to run a "/usr merge" script that would update the base filesystem hierarchy:
usr_merge_nag.sh: * WARNING: The current system is not /usr-merged. You are encouraged to * migrate manually to ensure the best-possible support. See * https://alpinelinux.org/posts/2025-10-01-usr-merge.html for more details
- Applying this change should not affect general users. For background information on this process, consult the news release, including its listing of the types of installations that may be affected.
- This update is not currently a requirement but will be implemented in the future.
- To attempt its implementation with a dry run first that should foresee errors in execution:
# As per a standard system upgrade to Edge or to a new release doas apk upgrade -aU # Install the script doas apk add merge-usr # Simulate the outcome of the merge: do a "dry run". This would report any errors onscreen doas merge-usr --dryrun # If any error is reported, it would be appreciated if you could kindly open an issue at https://gitlab.alpinelinux.org/alpine/aports/–/issues/new # WARNING: The next step would be to run the script, but it is only to be run as long as the steps above were performed without any errors doas merge-usr # The script would no longer be required and may now be deleted from the system doas apk del merge-usr # Remember to sync and reboot, as per usual after a system upgrade doas sync doas reboot