Include:Upgrading to Edge: Difference between revisions

Latest revision as of 04:43, 23 March 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.

The crucial difference is, that when editing the /etc/apk/repositories file, all referenced repository versions (such as v3.21 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
http://dl-cdn.alpinelinux.org/alpine/edge/testing

When using edge branch, testing repository can be added as shown above. Installing packages from testing repository with Edge branch and submitting bug reports is one of the best ways to contribute to Alpine Linux. Remember that, packages in testing repository have no support.

Warning: Do not enable stable release branch and edge repos at the same time. This can break your system. Either use edge or stable. If you mix stable and edge repositories, you're on your own.

After upgrading to edge, the currently installed edge version i.e the build date that is attached to the edge release may be checked with command:

$ cat /etc/alpine-release

@@ Line 1: / Line 1: @@
-An upgrade of Alpine Linux from a stable version to the rolling development version, ''edge'' can be done in a few simple steps. (These instructions assume that Alpine Linux is installed to a hard drive, rather than run-from-RAM.)
+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]].
-To begin, you need to update your {{Path|/etc/apk/repositories}} file. Here are some shortcuts for doing so:
+The crucial difference is, that 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
-:* Launch {{Cmd|setup-apkrepos}} Enter {{Key|e}} to edit {{Path|/etc/apk/repositories}}. Change the version number (such as <var>v2.5</var>) to '''edge'''.
+http://dl-cdn.alpinelinux.org/alpine/edge/main
-:* Or, edit the file in place: {{Cmd|sed -i -e 's/<var>v2\.5</var>/<var>edge</var>/g' /etc/apk/repositories}}
+http://dl-cdn.alpinelinux.org/alpine/edge/community
-  <!--
+http://dl-cdn.alpinelinux.org/alpine/edge/testing}}
-  cat /etc/alpine-release | cut -c 0-3
-  This is not working at the moment
-  cat /etc/alpine-release | cut -c 0-3 | sed -i -e 's/v{}/edge/g' /etc/apk/repositories
-  -->
-The result should look like this:
-{{Cat|/etc/apk/repositories|...
-http://dl-3.alpinelinux.org/alpine/edge/main}}
-<!--
+When using edge branch, [[Repositories#Testing|testing]] repository can be added as shown above. Installing packages from [[Repositories#Testing|testing]] repository with [[Repositories#Edge|Edge]] branch and submitting '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug reports]''' is one of the best ways to [[Contribute|contribute]] to Alpine Linux. Remember that, packages in [[Repositories#Testing|testing]] repository have no support.
-After updating the repositories file, obtain the latest index (and available packages, if you've [[Local APK cache|enabled APK caching]]):
-{{Cmd|apk update --update-cache}}
-Next, ensure you have the latest available version of the Alpine Linux Package Manager first before upgrading anything else:
+{{Warning|Do not enable [[Repositories#Release Branches|'''stable''']] release branch and [[Repositories#Edge|'''edge''']] repos at the same time. This can break your system. Either use edge '''or''' stable. If you mix stable and edge repositories, you're on your own.}}
-{{Cmd|apk add --upgrade apk-tools}}
+After upgrading to edge, the currently installed edge version i.e the build date that is attached to the '''edge''' release may be checked with command:{{Cmd|$ cat /etc/alpine-release}}
--->
-Next, upgrade all your packages in one shot: {{Cmd|apk upgrade --update-cache --available}}
-The <code>--available</code> switch is used to force all packages to be upgraded, even if they have the same version numbers. Sometimes changes in uClibc have required doing this.
-{{Note|You will need to restart any services that have been upgraded to begin using the upgraded versions. If the kernel is upgraded, you will need to reboot to begin using the upgraded version:
-{{Cmd|sync
-reboot}}
-}}
-To check your current release: {{Cmd|cat /etc/alpine-release}} You will see the build date attached to the release.
-[[Category:Package Manager]]
-[[Category:Installation]]
-[[Category:Development]]