Include:Upgrading to latest release - Revision history

Prabuanand: moved comment to the top of the page

2025-10-06T10:52:19Z

moved comment to the top of the page

← Older revision		Revision as of 10:52, 6 October 2025
Line 1:		Line 1:
			<!--- Note to the Editors.
			The {{#expr:{{AlpineLatest}}}} will fail if zero appears in the LSB of version numbers like 3.20, 3.30 etc. So, when such releases are around, this page requires manual handling. -->
	=== Update Repositories File ===		=== Update Repositories File ===

Line 6:		Line 8:

	Launch the [[Alpine_setup_scripts#setup-apkrepos\|<Code>setup-apkrepos</Code>]] script: {{Cmd\|# setup-apkrepos}} Pressing {{Key\|e}} will open the file to edit using [[BusyBox#vi\|'''vi''' editor]]. Edit the repository lines to reflect the new version number.		Launch the [[Alpine_setup_scripts#setup-apkrepos\|<Code>setup-apkrepos</Code>]] script: {{Cmd\|# setup-apkrepos}} Pressing {{Key\|e}} will open the file to edit using [[BusyBox#vi\|'''vi''' editor]]. Edit the repository lines to reflect the new version number.
	~~<!--- Note that {{#expr:{{AlpineLatest}}}} will fail if there is a zero as the LSB like 3.10,3.20,3.30. So, when such releases are around, this page requires manual handling. -->~~
	==== Using sed command ====		==== Using sed command ====

Prabuanand: fixed typo

2025-10-06T10:47:29Z

fixed typo

← Older revision		Revision as of 10:47, 6 October 2025
Line 14:		Line 14:

	Edit the {{Path\|/etc/apk/repositories}} file using any editor of your choice ({{Pkg\|nano}} for instance).		Edit the {{Path\|/etc/apk/repositories}} file using any editor of your choice ({{Pkg\|nano}} for instance).
	{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}-0.01}}/main		{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/v{{#expr:{{AlpineLatest}}-0.01}}/main
	http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}-0.01}}/community}}		http://dl-3.alpinelinux.org/alpine/v{{#expr:{{AlpineLatest}}-0.01}}/community}}
	In the above file, to upgrade Alpine Linux from version {{#expr:{{AlpineLatest}}-0.01}} to {{#expr:{{AlpineLatest}}}}, simply replace the number {{#expr:{{AlpineLatest}}-0.01}} by {{#expr:{{AlpineLatest}}}} in all the places:		In the above file, to upgrade Alpine Linux from version {{#expr:{{AlpineLatest}}-0.01}} to {{#expr:{{AlpineLatest}}}}, simply replace the number {{#expr:{{AlpineLatest}}-0.01}} by {{#expr:{{AlpineLatest}}}} in all the places:
	{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}}}/main		{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/v{{#expr:{{AlpineLatest}}}}/main
	http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}}}/community}}		http://dl-3.alpinelinux.org/alpine/v{{#expr:{{AlpineLatest}}}}/community}}

	==== Using '''latest-stable''' instead of version number====		==== Using '''latest-stable''' instead of version number====

Prabuanand: moved content from the include template to eliminate too many include levels

2025-10-06T10:40:56Z

moved content from the include template to eliminate too many include levels

← Older revision		Revision as of 10:40, 6 October 2025
Line 6:		Line 6:

	Launch the [[Alpine_setup_scripts#setup-apkrepos\|<Code>setup-apkrepos</Code>]] script: {{Cmd\|# setup-apkrepos}} Pressing {{Key\|e}} will open the file to edit using [[BusyBox#vi\|'''vi''' editor]]. Edit the repository lines to reflect the new version number.		Launch the [[Alpine_setup_scripts#setup-apkrepos\|<Code>setup-apkrepos</Code>]] script: {{Cmd\|# setup-apkrepos}} Pressing {{Key\|e}} will open the file to edit using [[BusyBox#vi\|'''vi''' editor]]. Edit the repository lines to reflect the new version number.
			<!--- Note that {{#expr:{{AlpineLatest}}}} will fail if there is a zero as the LSB like 3.10,3.20,3.30. So, when such releases are around, this page requires manual handling. -->
	==== Using sed command ====		==== Using sed command ====

Line 12:		Line 12:

	==== Manual editing of {{Path\|/etc/apk/repositories}}====		==== Manual editing of {{Path\|/etc/apk/repositories}}====
	{{:~~Include~~:~~Using_Internet_Repositories_for_apk~~-~~tools~~}}
			Edit the {{Path\|/etc/apk/repositories}} file using any editor of your choice ({{Pkg\|nano}} for instance).
			{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}-0.01}}/main
			http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}-0.01}}/community}}
			In the above file, to upgrade Alpine Linux from version {{#expr:{{AlpineLatest}}-0.01}} to {{#expr:{{AlpineLatest}}}}, simply replace the number {{#expr:{{AlpineLatest}}-0.01}} by {{#expr:{{AlpineLatest}}}} in all the places:
			{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}}}/main
			http://dl-3.alpinelinux.org/alpine/{{#expr:{{AlpineLatest}}}}/community}}

	==== Using '''latest-stable''' instead of version number====		==== Using '''latest-stable''' instead of version number====

Prabuanand: replaced the version numbers in sed command by {{AlpineLatest}} template

2025-10-06T10:38:27Z

replaced the version numbers in sed command by {{AlpineLatest}} template

← Older revision		Revision as of 10:38, 6 October 2025
Line 9:		Line 9:
	==== Using sed command ====		==== Using sed command ====

	Use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.20</var> to <var>~~v3.21~~</var>: {{Cmd\|# sed -i -e 's/<var>~~v3\~~.20</var>/<var>~~v3\.21~~</var>/g' /etc/apk/repositories}}		Use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>{{#expr:{{AlpineLatest}}-0.01}}</var> to <var>{{#expr:{{AlpineLatest}}}}</var>: {{Cmd\|# sed -i -e 's/<var>v{{#expr:{{AlpineLatest}}-0.01}}</var>/<var>v{{#expr:{{AlpineLatest}}}}</var>/g' /etc/apk/repositories}}

	==== Manual editing of {{Path\|/etc/apk/repositories}}====		==== Manual editing of {{Path\|/etc/apk/repositories}}====

Prabuanand: minor re wording to make it easier to read

2025-06-12T12:01:54Z

minor re wording to make it easier to read

← Older revision		Revision as of 12:01, 12 June 2025
Line 4:		Line 4:

	==== Using setup-apkrepos script====		==== Using setup-apkrepos script====

	Launch the [[Alpine_setup_scripts#setup-apkrepos\|<Code>setup-apkrepos</Code>]] script: {{Cmd\|# setup-apkrepos}} Pressing {{Key\|e}} will open the file to edit using [[BusyBox#vi\|'''vi''' editor]]. Edit the repository lines to reflect the new version number.		Launch the [[Alpine_setup_scripts#setup-apkrepos\|<Code>setup-apkrepos</Code>]] script: {{Cmd\|# setup-apkrepos}} Pressing {{Key\|e}} will open the file to edit using [[BusyBox#vi\|'''vi''' editor]]. Edit the repository lines to reflect the new version number.

	==== Using sed command ====		==== Using sed command ====

	Use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.20</var> to <var>v3.21</var>: {{Cmd\|# sed -i -e 's/<var>v3\.20</var>/<var>v3\.21</var>/g' /etc/apk/repositories}}		Use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.20</var> to <var>v3.21</var>: {{Cmd\|# sed -i -e 's/<var>v3\.20</var>/<var>v3\.21</var>/g' /etc/apk/repositories}}

Line 13:		Line 15:

	==== Using '''latest-stable''' instead of version number====		==== Using '''latest-stable''' instead of version number====

			Manual changes of the version numbers may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value in the repositories file.
	{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. Beware of the consequences.}}		{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. Beware of the consequences.}}
	~~Manual changes of the version numbers may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value in the~~ {{Path\|/etc/apk/repositories}} file as follows:{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/latest-stable/main		The {{Path\|/etc/apk/repositories}} file should appear as follows:{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/latest-stable/main
	http://dl-3.alpinelinux.org/alpine/latest-stable/community}}		http://dl-3.alpinelinux.org/alpine/latest-stable/community}}

Prabuanand: rephrased the sentence and moved the warning

2025-02-09T11:45:07Z

rephrased the sentence and moved the warning

← Older revision		Revision as of 11:45, 9 February 2025
Line 13:		Line 13:

	==== Using '''latest-stable''' instead of version number====		==== Using '''latest-stable''' instead of version number====
	~~Note, subsequent manual changes of the version numbers in~~ {{~~Path~~\|/~~etc/apk/repositories~~}} may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value:		{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. Beware of the consequences.}}
			Manual changes of the version numbers may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value in the {{Path\|/etc/apk/repositories}} file as follows:{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/latest-stable/main
	{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/latest-stable/main
	http://dl-3.alpinelinux.org/alpine/latest-stable/community}}		http://dl-3.alpinelinux.org/alpine/latest-stable/community}}
	{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. So beware of the consequences of unexpected release upgrades, when using <code>latest-stable</code>.}}

	=== Updating package lists ===		=== Updating package lists ===

Prabuanand: updated information for 3.21, removed category as this is an include page

2025-01-07T04:15:13Z

updated information for 3.21, removed category as this is an include page

← Older revision		Revision as of 04:15, 7 January 2025
Line 7:		Line 7:

	==== Using sed command ====		==== Using sed command ====
	Use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.19</var> to <var>v3.20</var>: {{Cmd\|# sed -i -e 's/<var>v3\.19</var>/<var>v3\.20</var>/g' /etc/apk/repositories}}		Use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.20</var> to <var>v3.21</var>: {{Cmd\|# sed -i -e 's/<var>v3\.20</var>/<var>v3\.21</var>/g' /etc/apk/repositories}}

	==== Manual editing of {{Path\|/etc/apk/repositories}}====		==== Manual editing of {{Path\|/etc/apk/repositories}}====
Line 40:		Line 40:
	reboot}}		reboot}}
	}}		}}

	~~[[Category:Package Manager]]~~
	~~[[Category:Installation]]~~

Prabuanand: rephrased sentence to make it easier to read

2024-11-23T06:15:55Z

rephrased sentence to make it easier to read

← Older revision		Revision as of 06:15, 23 November 2024
Line 1:		Line 1:
	=== Update Repositories File ===		=== Update Repositories File ===

	~~First step is to to check the~~ {{Path\|/etc/apk/repositories}} ~~file and update it~~ using one of the following methods.		The Repositories file {{Path\|/etc/apk/repositories}} can be updated using one of the following methods.

	==== Using setup-apkrepos script====		==== Using setup-apkrepos script====
	~~Launching~~ the ~~corresponding Alpine~~ setup script, {{Cmd\|# setup-apkrepos}} ~~and pressing~~ {{Key\|e}} to edit ~~{{Path\|/etc/apk/repositories}}~~ using ~~the default~~ [[BusyBox#vi\|vi]] ~~editor~~. ~~Then editing~~ the repository lines to reflect the new version number.		Launch the [[Alpine_setup_scripts#setup-apkrepos\|<Code>setup-apkrepos</Code>]] script: {{Cmd\|# setup-apkrepos}} Pressing {{Key\|e}} will open the file to edit using [[BusyBox#vi\|'''vi''' editor]]. Edit the repository lines to reflect the new version number.

	==== Using sed command ====		==== Using sed command ====
	~~One can also use~~ a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.19</var> to <var>v3.20</var>: {{Cmd\|# sed -i -e 's/<var>v3\.19</var>/<var>v3\.20</var>/g' /etc/apk/repositories}}		Use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.19</var> to <var>v3.20</var>: {{Cmd\|# sed -i -e 's/<var>v3\.19</var>/<var>v3\.20</var>/g' /etc/apk/repositories}}

	==== Manual editing of {{Path\|/etc/apk/repositories}}====		==== Manual editing of {{Path\|/etc/apk/repositories}}====

Prabuanand: removed whitespace

2024-11-22T19:02:52Z

removed whitespace

← Older revision		Revision as of 19:02, 22 November 2024
Line 15:		Line 15:
	Note, subsequent manual changes of the version numbers in {{Path\|/etc/apk/repositories}} may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value:		Note, subsequent manual changes of the version numbers in {{Path\|/etc/apk/repositories}} may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value:

	{{Cat\|/etc/apk/repositories\|		{{Cat\|/etc/apk/repositories\|http://dl-3.alpinelinux.org/alpine/latest-stable/main
	http://dl-3.alpinelinux.org/alpine/latest-stable/main
	http://dl-3.alpinelinux.org/alpine/latest-stable/community}}		http://dl-3.alpinelinux.org/alpine/latest-stable/community}}
	{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. So beware of the consequences of unexpected release upgrades, when using <code>latest-stable</code>}}		{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. So beware of the consequences of unexpected release upgrades, when using <code>latest-stable</code>.}}

	=== Updating package lists ===		=== Updating package lists ===

Prabuanand: fixed heading names to add clarity and added # to clarify that the commands require root privileges

2024-11-22T18:29:20Z

fixed heading names to add clarity and added # to clarify that the commands require root privileges

← Older revision		Revision as of 18:29, 22 November 2024
Line 1:		Line 1:
	=== Update ~~Repository Settings~~ ===		=== Update Repositories File ===

	First ~~thing~~ is to to check the {{Path\|/etc/apk/repositories}} file and ~~edit~~ it using one of the following methods.		First step is to to check the {{Path\|/etc/apk/repositories}} file and update it using one of the following methods.

	~~==== Manual editing of {{Path\|/etc/apk/repositories}}====~~
	~~{{:Include:Using_Internet_Repositories_for_apk-tools}}~~

	~~Besides doing it manually this may be done using one of the following shortcuts.~~
	==== Using setup-apkrepos script====		==== Using setup-apkrepos script====
	Launching the corresponding Alpine setup script, {{Cmd\|setup-apkrepos}} and pressing {{Key\|e}} to edit {{Path\|/etc/apk/repositories}} using the default [[BusyBox#vi\|vi]] editor. Then editing the repository lines to reflect the new version number.		Launching the corresponding Alpine setup script, {{Cmd\|# setup-apkrepos}} and pressing {{Key\|e}} to edit {{Path\|/etc/apk/repositories}} using the default [[BusyBox#vi\|vi]] editor. Then editing the repository lines to reflect the new version number.

	==== Using sed command ====		==== Using sed command ====
	One can also use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.19</var> to <var>v3.20</var>: {{Cmd\|sed -i -e 's/<var>v3\.19</var>/<var>v3\.20</var>/g' /etc/apk/repositories}}		One can also use a one-line command to edit all version numbers in the file "in place". Here's how you'd change <var>v3.19</var> to <var>v3.20</var>: {{Cmd\|# sed -i -e 's/<var>v3\.19</var>/<var>v3\.20</var>/g' /etc/apk/repositories}}

	==== ~~latest-stable~~====		==== Manual editing of {{Path\|/etc/apk/repositories}}====
			{{:Include:Using_Internet_Repositories_for_apk-tools}}

			==== Using '''latest-stable''' instead of version number====
	Note, subsequent manual changes of the version numbers in {{Path\|/etc/apk/repositories}} may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value:		Note, subsequent manual changes of the version numbers in {{Path\|/etc/apk/repositories}} may be avoided for future release upgrades by having the repository lines refer to "latest-stable" instead of an absolute value:

Line 20:		Line 18:
	http://dl-3.alpinelinux.org/alpine/latest-stable/main		http://dl-3.alpinelinux.org/alpine/latest-stable/main
	http://dl-3.alpinelinux.org/alpine/latest-stable/community}}		http://dl-3.alpinelinux.org/alpine/latest-stable/community}}

	{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. So beware of the consequences of unexpected release upgrades, when using <code>latest-stable</code>}}		{{Warning\|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades. So beware of the consequences of unexpected release upgrades, when using <code>latest-stable</code>}}

	=== Updating package lists ===		=== Updating package lists ===

	With the correct repositories file in place, the latest index list of available packages can be obtained with:		With the correct repositories file in place, the latest index list of available packages can be obtained with:
	{{Cmd\|apk update}}		{{Cmd\|# apk update}}

	{{Tip\|Adding the <code>--update-cache</code> or <code>-U</code> to another apk command, as in <code>apk add -U ...</code> or <code>apk upgrade -U</code>, has the same effect as always running <code>apk update</code> immediately before the other apk command. Instead of auto-update it only if the index has not been updated recently.}}		{{Tip\|Adding the <code>--update-cache</code> or <code>-U</code> to another apk command, as in <code>apk add -U ...</code> or <code>apk upgrade -U</code>, has the same effect as always running <code>apk update</code> immediately before the other apk command. Instead of auto-update it only if the index has not been updated recently.}}
Line 33:		Line 29:

	At times it is required to first upgrade just the Alpine Linux Package Manager itself to the latest available version, before upgrading any other package. This was the case, for example, when upgrading from a version of Alpine before 2.3.0_rc1. But simply always doing so shouldn't hurt, either:		At times it is required to first upgrade just the Alpine Linux Package Manager itself to the latest available version, before upgrading any other package. This was the case, for example, when upgrading from a version of Alpine before 2.3.0_rc1. But simply always doing so shouldn't hurt, either:
	{{Cmd\|apk add --upgrade apk-tools}}		{{Cmd\|# apk add --upgrade apk-tools}}

	Next, to upgrade all installed packages:		Next, to upgrade all installed packages:
	{{Cmd\|apk upgrade --available}}		{{Cmd\|# apk upgrade --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 musl require doing this.		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 musl require doing this.