Include:Upgrading to Edge - Revision history

Prabuanand: moved content to Edge as this is not specific to upgrading to Edge

2025-11-28T04:07:15Z

moved content to Edge as this is not specific to upgrading to Edge

← Older revision		Revision as of 04:07, 28 November 2025
Line 5:		Line 5:
	http://dl-cdn.alpinelinux.org/alpine/edge/community		http://dl-cdn.alpinelinux.org/alpine/edge/community
	@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}		@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}

	When the upgrade completes, ''edge'' currently issues a messege encouraging users to install {{pkg\|merge-usr}} package, that would update the base filesystem hierarchy. Consult [https://alpinelinux.org/posts/2025-10-01-usr-merge.html news release on usr-merge] for background information including the rationale.

	This update is currently not a requirement, but will be implemented in the future as part of standard system upgrade to a [[Upgrading_Alpine#Upgrading_to_latest_release\|new release]] as mentioned in {{Issue\|17624}}.

	{{Warning\|If any error is reported on running {{ic\|$ doas merge-usr --dryrun}}, do not proceed with next steps, as this would break your system. Instead, it would be appreciated if you could kindly submit a '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug report]''' and provide all requested information when doing so.}}

Prabuanand: fixed mistake

2025-11-28T03:55:16Z

fixed mistake

← Older revision		Revision as of 03:55, 28 November 2025
Line 6:		Line 6:
	@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}		@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}

	When the upgrade completes, ''edge'' currently issues a messege encouraging users ~~to migrate manually~~ to install {{pkg\|merge-usr}} package, that would update the base filesystem hierarchy. Consult [https://alpinelinux.org/posts/2025-10-01-usr-merge.html news release on usr-merge] for background information including the rationale.		When the upgrade completes, ''edge'' currently issues a messege encouraging users to install {{pkg\|merge-usr}} package, that would update the base filesystem hierarchy. Consult [https://alpinelinux.org/posts/2025-10-01-usr-merge.html news release on usr-merge] for background information including the rationale.

	This update is currently not a requirement, but will be implemented in the future as part of standard system upgrade to a [[Upgrading_Alpine#Upgrading_to_latest_release\|new release]] as mentioned in {{Issue\|17624}}.		This update is currently not a requirement, but will be implemented in the future as part of standard system upgrade to a [[Upgrading_Alpine#Upgrading_to_latest_release\|new release]] as mentioned in {{Issue\|17624}}.

	{{Warning\|If any error is reported on running {{ic\|$ doas merge-usr --dryrun}}, do not proceed with next steps, as this would break your system. Instead, it would be appreciated if you could kindly submit a '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug report]''' and provide all requested information when doing so.}}		{{Warning\|If any error is reported on running {{ic\|$ doas merge-usr --dryrun}}, do not proceed with next steps, as this would break your system. Instead, it would be appreciated if you could kindly submit a '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug report]''' and provide all requested information when doing so.}}

Prabuanand: added warning and links and removed nag message contents as usr-merge page has necessary info

2025-11-28T03:51:43Z

added warning and links and removed nag message contents as usr-merge page has necessary info

@@ 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
 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}}
-# 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
+When the upgrade completes, ''edge'' currently issues a messege encouraging users to migrate manually to install {{pkg|merge-usr}} package, that would update the base filesystem hierarchy. Consult [https://alpinelinux.org/posts/2025-10-01-usr-merge.html news release on usr-merge] for background information including the rationale.
-# The script would no longer be required and may now be deleted from the system
+This update is currently not a requirement, but will be implemented in the future as part of standard system upgrade to a [[Upgrading_Alpine#Upgrading_to_latest_release|new release]] as mentioned in {{Issue|17624}}.
-# Remember to sync and reboot, as per usual after a system upgrade
+{{Warning|If any error is reported on running {{ic|$ doas merge-usr --dryrun}}, do not proceed with next steps, as this would break your system. Instead, it would be appreciated if you could kindly submit a '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug report]''' and provide all requested information when doing so.}}

John3-16: Updated nag message

2025-11-27T19:26:39Z

Updated nag message

← Older revision		Revision as of 19:26, 27 November 2025
Line 10:		Line 10:
	<pre>		<pre>
	usr_merge_nag.sh:		usr_merge_nag.sh:
	* WARNING: The current system is not /usr-merged. You are encouraged to		* WARNING: The current system is not /usr-merged.
	* migrate manually to ensure ~~the best-possible support~~. ~~See~~		* You are encouraged to migrate manually to ensure system reliability.
	* https://alpinelinux.org/posts/2025-10-01-usr-merge.html for more details		*
			* See https://alpinelinux.org/posts/2025-10-01-usr-merge.html for more
			* details.
			*
			* You can disable this message by masking the usr-merge-nag package:
			* apk add '!usr-merge-nag'
	</pre>		</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.		: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.

John3-16: Undo revision 31419 by John3-16 - Undid this revision also, which added "As indicated above", since usr_merge_nag.sh does not currently indicate that the /usr-merge will be implemented in the future, so it is not "indicated [above/there]: the merge request pipeline that would have enacted the revision was skipped (see previous change).

2025-11-15T05:20:40Z

Undo revision 31419 by John3-16 - Undid this revision also, which added "As indicated above", since usr_merge_nag.sh does not currently indicate that the /usr-merge will be implemented in the future, so it is not "indicated [above/there]: the merge request pipeline that would have enacted the revision was skipped (see previous change).

← Older revision		Revision as of 05:20, 15 November 2025
Line 15:		Line 15:
	</pre>		</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.		: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.		: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:		:To attempt its implementation with a dry run first that should foresee errors in execution:
	<pre>		<pre>

John3-16: Undo revision 31418 by John3-16 - Undid my revision, as the merge request pipeline that updated the text in the usr_merge_nag.sh script (https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/diffs) was skipped: https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/pipelines?commit_id=0db52277bea433ba4241117d4860cc7ca14e532f

2025-11-15T05:09:29Z

Undo revision 31418 by John3-16 - Undid my revision, as the merge request pipeline that updated the text in the usr_merge_nag.sh script (https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/diffs) was skipped: https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/pipelines?commit_id=0db52277bea433ba4241117d4860cc7ca14e532f

← Older revision		Revision as of 05:09, 15 November 2025
Line 7:		Line 7:
	http://dl-cdn.alpinelinux.org/alpine/edge/community		http://dl-cdn.alpinelinux.org/alpine/edge/community
	@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}		@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:		* When the upgrade completes, ''edge'' currently issues an encouragement to run a ''"/usr merge"'' script that would update the base filesystem hierarchy:
	<pre>		<pre>
	usr_merge_nag.sh:		usr_merge_nag.sh:
	* ~~INFO~~: The current system is not /usr-merged.		* WARNING: The current system is not /usr-merged. You are encouraged to
	* In the ~~future, the /usr~~-~~merge will be compulsory and the migration will happen~~		* migrate manually to ensure the best-possible support. See
	* automatically. ~~You can help testing the migration path by running it manually~~		* https://alpinelinux.org/posts/2025-10-01-usr-merge.html for more details
	* 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>		</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.		: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.

John3-16: Added "As indicated above," to "This update is not currently a requirement but will be implemented in the future."

2025-11-06T17:25:42Z

Added "As indicated above," to "This update is not currently a requirement but will be implemented in the future."

← Older revision		Revision as of 17:25, 6 November 2025
Line 24:		Line 24:
	</pre>		</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.		: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.
	:~~This~~ update is not currently a requirement but will be implemented in the future.		: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:		:To attempt its implementation with a dry run first that should foresee errors in execution:
	<pre>		<pre>

John3-16: 1. Updated usr_merge_nag.sh text to reflect https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/diffs 2. Modified "/usr merge" to "/usr-merge"

2025-11-06T17:00:52Z

1. Updated usr_merge_nag.sh text to reflect https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/91806/diffs 2. Modified "/usr merge" to "/usr-merge"

← Older revision		Revision as of 17:00, 6 November 2025
Line 7:		Line 7:
	http://dl-cdn.alpinelinux.org/alpine/edge/community		http://dl-cdn.alpinelinux.org/alpine/edge/community
	@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}		@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:		* When the upgrade completes, ''edge'' currently issues an encouragement to run a ''"/usr-merge"'' script that would update the base filesystem hierarchy:
	<pre>		<pre>
	usr_merge_nag.sh:		usr_merge_nag.sh:
	* ~~WARNING~~: The current system is not /usr-merged. You ~~are encouraged to~~		* INFO: The current system is not /usr-merged.
	* ~~migrate manually to ensure~~ the ~~best~~-~~possible support. See~~		* In the future, the /usr-merge will be compulsory and the migration will happen
	* https://alpinelinux.org/posts/2025-10-01-usr-merge.html for more details		* 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>		</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.		: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.

John3-16: Added "/usr merge" instructions

2025-10-08T17:41:39Z

Added "/usr merge" instructions

@@ 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]].
-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
+There are only two differences:-
 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}}

Prabuanand: moved content from here to Repositories page

2025-10-03T17:38:16Z

moved content from here to Repositories page

← Older revision		Revision as of 17:38, 3 October 2025
Line 5:		Line 5:
	http://dl-cdn.alpinelinux.org/alpine/edge/community		http://dl-cdn.alpinelinux.org/alpine/edge/community
	@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}		@testing http://dl-cdn.alpinelinux.org/alpine/edge/testing}}

	When using edge branch, [[Repositories#Testing\|testing]] repository can be added as a [[Repositories#Tagged repository\|tagged repository]] as shown above. Remember that, packages in [[Repositories#Testing\|testing]] repository have no support.

	{{Warning\|Do not enable Main/Community repositories from both [[Repositories#Release Branches\|'''stable''']] release branch and [[Repositories#Edge\|'''edge''']] 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:{{Cmd\|$ cat /etc/alpine-release}}~~