Include:Upgrading to Edge: Difference between revisions

Latest revision as of 04:07, 28 November 2025

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.

When editing the /etc/apk/repositories file, all referenced repository versions (such as v3.23 or latest-stable) therein need to be pointing to edge 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

@@ Line 1: / Line 1: @@
 An upgrade of Alpine Linux from a stable version to the rolling development version ''edge'' basically requires the same steps as [[Upgrading_Alpine#Upgrading_to_latest_release|Upgrading to latest release]].
-There are only two differences:-
+When editing the {{Path|/etc/apk/repositories}} file, all referenced repository versions (such as {{ic|v{{#expr:{{AlpineLatest}}}}}} or {{ic|latest-stable}}) therein need to be pointing to <code>'''edge'''</code> as follows. {{cat|/etc/apk/repositories|#/media/cdrom/apks
-* When editing the {{Path|/etc/apk/repositories}} file, all referenced repository versions (such as {{ic|v{{#expr:{{AlpineLatest}}}}}} or {{ic|latest-stable}}) therein need to be pointing to <code>'''edge'''</code> as follows. {{cat|/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:
-<pre>
-usr_merge_nag.sh:
-* INFO: The current system is not /usr-merged.
-* In the future, the /usr-merge will be compulsory and the migration will happen
-* automatically. You can help testing the migration path by running it manually
-* before, but there might be known and unknown bugs at the time of migration:
-* https://gitlab.alpinelinux.org/groups/alpine/-/milestones/16
-*
-* See https://alpinelinux.org/posts/2025-10-01-usr-merge.html and
-* https://gitlab.alpinelinux.org/alpine/aports/-/issues/17624#note_551336
-* for more details.
-*
-* You can disable this message by masking the usr-merge-nag package:
-*   apk add '!usr-merge-nag'
-</pre>
-:Applying this change should not affect general users.  For background  information on this process, consult the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html news release], including its listing of the types of installations that may be affected.
-:As indicated above, 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:
-<pre>
-# 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
-</pre>