mirror of
				https://github.com/juanfont/headscale.git
				synced 2025-10-28 10:51:44 +01:00 
			
		
		
		
	Separate the term "tailnet" from user and be more explicit about providing a single tailnet. Also be more explicit about users. Refer to "headscale users" when mentioning commandline invocations and use the term "local users" when discussing unix accounts. Fixes: #2335
		
			
				
	
	
		
			56 lines
		
	
	
		
			1.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			56 lines
		
	
	
		
			1.8 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
# Community packages
 | 
						|
 | 
						|
Several Linux distributions and community members provide packages for headscale. Those packages may be used instead of
 | 
						|
the [official releases](./official.md) provided by the headscale maintainers. Such packages offer improved integration
 | 
						|
for their targeted operating system and usually:
 | 
						|
 | 
						|
- setup a dedicated local user account to run headscale
 | 
						|
- provide a default configuration
 | 
						|
- install headscale as system service
 | 
						|
 | 
						|
!!! warning "Community packages might be outdated"
 | 
						|
 | 
						|
    The packages mentioned on this page might be outdated or unmaintained. Use the [official releases](./official.md) to
 | 
						|
    get the current stable version or to test pre-releases.
 | 
						|
 | 
						|
    [](https://repology.org/project/headscale/versions)
 | 
						|
 | 
						|
## Arch Linux
 | 
						|
 | 
						|
Arch Linux offers a package for headscale, install via:
 | 
						|
 | 
						|
```shell
 | 
						|
pacman -S headscale
 | 
						|
```
 | 
						|
 | 
						|
The [AUR package `headscale-git`](https://aur.archlinux.org/packages/headscale-git) can be used to build the current
 | 
						|
development version.
 | 
						|
 | 
						|
## Fedora, RHEL, CentOS
 | 
						|
 | 
						|
A third-party repository for various RPM based distributions is available at:
 | 
						|
<https://copr.fedorainfracloud.org/coprs/jonathanspw/headscale/>. The site provides detailed setup and installation
 | 
						|
instructions.
 | 
						|
 | 
						|
## Nix, NixOS
 | 
						|
 | 
						|
A Nix package is available as: `headscale`. See the [NixOS package site for installation
 | 
						|
details](https://search.nixos.org/packages?show=headscale).
 | 
						|
 | 
						|
## Gentoo
 | 
						|
 | 
						|
```shell
 | 
						|
emerge --ask net-vpn/headscale
 | 
						|
```
 | 
						|
 | 
						|
Gentoo specific documentation is available [here](https://wiki.gentoo.org/wiki/User:Maffblaster/Drafts/Headscale).
 | 
						|
 | 
						|
## OpenBSD
 | 
						|
 | 
						|
Headscale is available in ports. The port installs headscale as system service with `rc.d` and provides usage
 | 
						|
instructions upon installation.
 | 
						|
 | 
						|
```shell
 | 
						|
pkg_add headscale
 | 
						|
```
 |