Repositories - Revision history

Fturco: avoid redirect

2026-05-03T11:43:05Z

avoid redirect

← Older revision		Revision as of 11:43, 3 May 2026
Line 31:		Line 31:
	'''Edge''' is the name given to the current [[Aports tree\|development tree]] of Alpine Linux. The ''edge'' branch includes all three [[#Official repositories\|official repositories]] and contains the latest build of all available Alpine Linux packages. Those packages are updated on a regular basis. Since ''edge'' is a development branch, many changes are not heavily tested (or tested at all), and packages can and sometimes do break without warning. ''edge'' can be considered as the '''rolling release version''' of Alpine Linux.		'''Edge''' is the name given to the current [[Aports tree\|development tree]] of Alpine Linux. The ''edge'' branch includes all three [[#Official repositories\|official repositories]] and contains the latest build of all available Alpine Linux packages. Those packages are updated on a regular basis. Since ''edge'' is a development branch, many changes are not heavily tested (or tested at all), and packages can and sometimes do break without warning. ''edge'' can be considered as the '''rolling release version''' of Alpine Linux.

	[[#Upgrading to edge\|Upgrading to the ''edge'']] branch and installing packages from [[Repositories#Testing\|''testing'']] repository, and then submitting '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug reports]''' is one of the best ways to [[Contribute\|contribute]] to Alpine Linux. This is a very valuable activity that helps Alpine Linux development, as it ensures that the quality of stable releases is high.		[[#Upgrading to edge\|Upgrading to the ''edge'']] branch and installing packages from [[Repositories#Testing\|''testing'']] repository, and then submitting '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug reports]''' is one of the best ways to [[Alpine Linux:Contribute\|contribute]] to Alpine Linux. This is a very valuable activity that helps Alpine Linux development, as it ensures that the quality of stable releases is high.

	The currently installed ''edge'' version – i.e the build date that is attached to the ''edge'' release – may be checked with the command:{{Cmd\|$ cat /etc/alpine-release}}		The currently installed ''edge'' version – i.e the build date that is attached to the ''edge'' release – may be checked with the command:{{Cmd\|$ cat /etc/alpine-release}}

John3-16: Style/grammar amendments; repos standardized to italics, as per majority use on this page, but preserving boldface in introductory instances.

2026-02-03T23:57:01Z

Style/grammar amendments; repos standardized to italics, as per majority use on this page, but preserving boldface in introductory instances.

Show changes

Prabuanand: fixed typo

2025-12-05T15:56:25Z

fixed typo

← Older revision		Revision as of 15:56, 5 December 2025
Line 36:		Line 36:
	{{Warning\|Do not use [[#Edge\|''edge'' branch]] in production, or if you desire deterministic, repeatable package installation (such as with containerized environments) via [[Alpine Package Keeper#Package pinning\|package pinning]] as it is under constant development and instead use a [[#Release Branches\|stable release branch]].}}		{{Warning\|Do not use [[#Edge\|''edge'' branch]] in production, or if you desire deterministic, repeatable package installation (such as with containerized environments) via [[Alpine Package Keeper#Package pinning\|package pinning]] as it is under constant development and instead use a [[#Release Branches\|stable release branch]].}}

	=== Message on ~~user-~~merge ===		=== Message on /usr merge ===

	''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.		''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.

Prabuanand: fixed the single quote based on reminder in Talk:Include:Upgrading_to_Edge#usr_merge from John3-16

2025-11-28T14:35:45Z

fixed the single quote based on reminder in Talk:Include:Upgrading_to_Edge#usr_merge from John3-16

← Older revision		Revision as of 14:35, 28 November 2025
Line 40:		Line 40:
	''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.		''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 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add !usr-merge-nag}}		This 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add '!usr-merge-nag'}}

	{{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: rewrote to clarify that a package is supported for six months once a package is released as part of stable release

2025-11-28T05:20:13Z

rewrote to clarify that a package is supported for six months once a package is released as part of stable release

← Older revision		Revision as of 05:20, 28 November 2025
Line 13:		Line 13:
	=== Community ===		=== Community ===

	Packages in '''community''' repository are those made by users in team with the official developers and close to the Alpine package process. They are supported by those user(s) contributions, and support ends [https://docs.alpinelinux.org/user-handbook/0.1a/Working/apk.html#_repositories_releases_and_mirrors six months after their release] ~~or if the user(s) stops~~. They may also be removed in a future release due to lack of support by upstream authors.		Packages in '''community''' repository are those made by users in team with the official developers and close to the Alpine package process. They are supported by those user(s) contributions, and support ends [https://docs.alpinelinux.org/user-handbook/0.1a/Working/apk.html#_repositories_releases_and_mirrors six months after their release]. They may also be removed in a future release due to lack of support by upstream authors or rarely, if the user(s) contribution stops.

	If packages from community repository are used, one would need to upgrade that repo [[Upgrading_Alpine#Upgrading_to_latest_release\|to the latest stable release branch]] to continue to have support.		If packages from community repository are used, one would need to upgrade that repo [[Upgrading_Alpine#Upgrading_to_latest_release\|to the latest stable release branch]] to continue to have support.

Prabuanand: fixed typo

2025-11-28T04:04:49Z

fixed typo

← Older revision		Revision as of 04:04, 28 November 2025
Line 40:		Line 40:
	''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.		''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 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add !usr-merge-nag}}.		This 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add !usr-merge-nag}}

	{{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: moved from Include:Upgrading to Edge as this nag appears at every update in edge, until the nag is disabled

2025-11-28T04:03:37Z

moved from Include:Upgrading to Edge as this nag appears at every update in edge, until the nag is disabled

← Older revision		Revision as of 04:03, 28 November 2025
Line 35:		Line 35:
	The current 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}}		The current 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}}
	{{Warning\|Do not use [[#Edge\|''edge'' branch]] in production, or if you desire deterministic, repeatable package installation (such as with containerized environments) via [[Alpine Package Keeper#Package pinning\|package pinning]] as it is under constant development and instead use a [[#Release Branches\|stable release branch]].}}		{{Warning\|Do not use [[#Edge\|''edge'' branch]] in production, or if you desire deterministic, repeatable package installation (such as with containerized environments) via [[Alpine Package Keeper#Package pinning\|package pinning]] as it is under constant development and instead use a [[#Release Branches\|stable release branch]].}}

			=== Message on user-merge ===

			''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 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add !usr-merge-nag}}.

			{{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.}}

	== Managing repositories ==		== Managing repositories ==

John3-16: /* Community */ Added that support for community packages ends six months after their release, giving reference to docs; style amendment

2025-11-27T01:19:30Z

Community: Added that support for community packages ends six months after their release, giving reference to docs; style amendment

← Older revision		Revision as of 01:19, 27 November 2025
Line 13:		Line 13:
	=== Community ===		=== Community ===

	Packages in '''community''' repository are those made by users in team with the official developers and close to the Alpine package process. They are supported by those user(s) contributions and ~~could end~~ if the user(s) stops~~; they~~ may also be removed in a future release due to lack of support by upstream authors.		Packages in '''community''' repository are those made by users in team with the official developers and close to the Alpine package process. They are supported by those user(s) contributions, and support ends [https://docs.alpinelinux.org/user-handbook/0.1a/Working/apk.html#_repositories_releases_and_mirrors six months after their release] or if the user(s) stops. They may also be removed in a future release due to lack of support by upstream authors.

	If packages from community repository are used, one ~~needs~~ to [[Upgrading_Alpine#Upgrading_to_latest_release\|~~upgrade~~ to the latest stable release branch]] to continue to have support.		If packages from community repository are used, one would need to upgrade that repo [[Upgrading_Alpine#Upgrading_to_latest_release\|to the latest stable release branch]] to continue to have support.

	=== Testing ===		=== Testing ===

Prabuanand: fixed sentence

2025-10-27T05:16:08Z

fixed sentence

← Older revision		Revision as of 05:16, 27 October 2025
Line 70:		Line 70:
	Follow the instructions for [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge\|Upgrading to Edge]].		Follow the instructions for [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge\|Upgrading to Edge]].

	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.		When using edge branch, [[Repositories#Testing\|testing]] repository can be added as a [[Repositories#Tagged repository\|tagged repository]]. 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.}}		{{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.}}

Prabuanand: removed the transclusion and added wikilink

2025-10-27T05:13:13Z

removed the transclusion and added wikilink

← Older revision		Revision as of 05:13, 27 October 2025
Line 68:		Line 68:
	=== Upgrading to edge ===		=== Upgrading to edge ===

	~~{{:Include:~~Upgrading to Edge}}		Follow the instructions for [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge\|Upgrading to Edge]].

	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.		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.

← Older revision		Revision as of 11:43, 3 May 2026
Line 31:		Line 31:
	'''Edge''' is the name given to the current [[Aports tree\|development tree]] of Alpine Linux. The ''edge'' branch includes all three [[#Official repositories\|official repositories]] and contains the latest build of all available Alpine Linux packages. Those packages are updated on a regular basis. Since ''edge'' is a development branch, many changes are not heavily tested (or tested at all), and packages can and sometimes do break without warning. ''edge'' can be considered as the '''rolling release version''' of Alpine Linux.		'''Edge''' is the name given to the current [[Aports tree\|development tree]] of Alpine Linux. The ''edge'' branch includes all three [[#Official repositories\|official repositories]] and contains the latest build of all available Alpine Linux packages. Those packages are updated on a regular basis. Since ''edge'' is a development branch, many changes are not heavily tested (or tested at all), and packages can and sometimes do break without warning. ''edge'' can be considered as the '''rolling release version''' of Alpine Linux.

	[[#Upgrading to edge\|Upgrading to the ''edge'']] branch and installing packages from [[Repositories#Testing\|''testing'']] repository, and then submitting '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug reports]''' is one of the best ways to [[Contribute\|contribute]] to Alpine Linux. This is a very valuable activity that helps Alpine Linux development, as it ensures that the quality of stable releases is high.		[[#Upgrading to edge\|Upgrading to the ''edge'']] branch and installing packages from [[Repositories#Testing\|''testing'']] repository, and then submitting '''[https://gitlab.alpinelinux.org/alpine/aports/issues bug reports]''' is one of the best ways to [[Alpine Linux:Contribute\|contribute]] to Alpine Linux. This is a very valuable activity that helps Alpine Linux development, as it ensures that the quality of stable releases is high.

	The currently installed ''edge'' version – i.e the build date that is attached to the ''edge'' release – may be checked with the command:{{Cmd\|$ cat /etc/alpine-release}}		The currently installed ''edge'' version – i.e the build date that is attached to the ''edge'' release – may be checked with the command:{{Cmd\|$ cat /etc/alpine-release}}

← Older revision		Revision as of 14:35, 28 November 2025
Line 40:		Line 40:
	''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.		''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 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add !usr-merge-nag}}		This 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add '!usr-merge-nag'}}

	{{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.}}

← Older revision		Revision as of 04:04, 28 November 2025
Line 40:		Line 40:
	''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.		''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 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add !usr-merge-nag}}.		This 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}}. You can disable this nag message by masking the usr-merge-nag package: {{Cmd\|$ doas apk add !usr-merge-nag}}

	{{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.}}

← Older revision		Revision as of 05:16, 27 October 2025
Line 70:		Line 70:
	Follow the instructions for [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge\|Upgrading to Edge]].		Follow the instructions for [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge\|Upgrading to Edge]].

	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.		When using edge branch, [[Repositories#Testing\|testing]] repository can be added as a [[Repositories#Tagged repository\|tagged repository]]. 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.}}		{{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.}}