mirror of
				https://github.com/juanfont/headscale.git
				synced 2025-10-28 10:51:44 +01:00 
			
		
		
		
	Merge branch 'main' into reduce-binary-size
This commit is contained in:
		
						commit
						3837f1714a
					
				@ -65,7 +65,7 @@ To contribute to Headscale you would need the lastest version of [Go](https://go
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
### Code style
 | 
					### Code style
 | 
				
			||||||
 | 
					
 | 
				
			||||||
To ensure we have some consistency with a growing number of contributes, this project has adopted linting and style/formatting rules:
 | 
					To ensure we have some consistency with a growing number of contributions, this project has adopted linting and style/formatting rules:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The **Go** code is linted with [`golangci-lint`](https://golangci-lint.run) and
 | 
					The **Go** code is linted with [`golangci-lint`](https://golangci-lint.run) and
 | 
				
			||||||
formatted with [`golines`](https://github.com/segmentio/golines) (width 88) and
 | 
					formatted with [`golines`](https://github.com/segmentio/golines) (width 88) and
 | 
				
			||||||
@ -76,7 +76,7 @@ run `make lint` and `make fmt` before committing any code.
 | 
				
			|||||||
The **Proto** code is linted with [`buf`](https://docs.buf.build/lint/overview) and
 | 
					The **Proto** code is linted with [`buf`](https://docs.buf.build/lint/overview) and
 | 
				
			||||||
formatted with [`clang-format`](https://clang.llvm.org/docs/ClangFormat.html).
 | 
					formatted with [`clang-format`](https://clang.llvm.org/docs/ClangFormat.html).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The **rest** (markdown, yaml, etc) is formatted with [`prettier`](https://prettier.io).
 | 
					The **rest** (Markdown, YAML, etc) is formatted with [`prettier`](https://prettier.io).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Check out the `.golangci.yaml` and `Makefile` to see the specific configuration.
 | 
					Check out the `.golangci.yaml` and `Makefile` to see the specific configuration.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -92,7 +92,7 @@ make install-protobuf-plugins
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
### Testing and building
 | 
					### Testing and building
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Some parts of the project requires the generation of Go code from Protobuf (if changes is made in `proto/`) and it must be (re-)generated with:
 | 
					Some parts of the project require the generation of Go code from Protobuf (if changes are made in `proto/`) and it must be (re-)generated with:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```shell
 | 
					```shell
 | 
				
			||||||
make generate
 | 
					make generate
 | 
				
			||||||
 | 
				
			|||||||
@ -21,7 +21,7 @@ wget --output-document=/usr/local/bin/headscale \
 | 
				
			|||||||
chmod +x /usr/local/bin/headscale
 | 
					chmod +x /usr/local/bin/headscale
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
3. Prepare a direction to hold `headscale` configuration and the [SQLite](https://www.sqlite.org/) database:
 | 
					3. Prepare a directory to hold `headscale` configuration and the [SQLite](https://www.sqlite.org/) database:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```shell
 | 
					```shell
 | 
				
			||||||
# Directory for configuration
 | 
					# Directory for configuration
 | 
				
			||||||
@ -32,7 +32,7 @@ mkdir -p /etc/headscale
 | 
				
			|||||||
mkdir -p /var/lib/headscale
 | 
					mkdir -p /var/lib/headscale
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
4. Create an empty SQlite datebase:
 | 
					4. Create an empty SQLite database:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```shell
 | 
					```shell
 | 
				
			||||||
touch /var/lib/headscale/db.sqlite
 | 
					touch /var/lib/headscale/db.sqlite
 | 
				
			||||||
@ -106,7 +106,7 @@ tailscale up --login-server <YOUR_HEADSCALE_URL> --authkey <YOUR_AUTH_KEY>
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
## Running `headscale` in the background with SystemD
 | 
					## Running `headscale` in the background with SystemD
 | 
				
			||||||
 | 
					
 | 
				
			||||||
In this section it will be demonstrated how to run `headscale` as a service in the background with [SystemD](https://www.freedesktop.org/wiki/Software/systemd/).
 | 
					This section demonstrates how to run `headscale` as a service in the background with [SystemD](https://www.freedesktop.org/wiki/Software/systemd/).
 | 
				
			||||||
This should work on most modern Linux distributions.
 | 
					This should work on most modern Linux distributions.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Create a SystemD service configuration at `/etc/systemd/system/headscale.service` containing:
 | 
					1. Create a SystemD service configuration at `/etc/systemd/system/headscale.service` containing:
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
		Reference in New Issue
	
	Block a user