Skip to content

Commit 5da39f9

Browse files
committed
Readme improved
1 parent 6a39734 commit 5da39f9

File tree

1 file changed

+31
-9
lines changed

1 file changed

+31
-9
lines changed

README.md

Lines changed: 31 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,27 @@
1-
# headscale
1+
# Headscale
22
An open source implementation of the Tailscale coordination server.
33

44

5-
## Disclaimer
5+
## Status
6+
7+
- [x] Basic functionality (nodes can communicate with each other)
8+
- [x] Node registration through the web flow
9+
- [x] Network changes are relied to the nodes
10+
- [ ] Node registration via pre-auth keys
11+
- [ ] Multiuser support
12+
- [ ] ACLs
13+
- [ ] DNS
14+
15+
... and probably lots of stuff missing
16+
17+
## Roadmap 🤷
18+
19+
Adding multiuser support seems doable. Rather than actual users, this multi-tenancy will probably look more like namespaces in Kubernetes - a logical partitioning of resources created with a CLI.
20+
21+
Pre-auth keys should also be feasible.
22+
23+
Suggestions/PRs welcomed!
624

7-
1. I have nothing to do with Tailscale, or Tailscale Inc. Just a fan of their tech.
8-
2. The purpose of writing this was to learn a bit how Tailscale works. Hence the emojis in the log messages and other terrible code.
9-
3. I don't use Headscale myself (their Solo plan + DERP infra is way more convenient).
10-
4. Headscale adds all the machines under the same user. Be careful!
1125

1226

1327
## Running it
@@ -17,7 +31,7 @@ An open source implementation of the Tailscale coordination server.
1731
go build cmd/headscale/headscale.go
1832
```
1933

20-
2. Get youself a PostgreSQL DB running.
34+
2. Get youself a PostgreSQL DB running (yes, [I know](https://tailscale.com/blog/an-unlikely-database-migration/))
2135

2236
```shell
2337
docker run --name headscale -e POSTGRES_DB=headscale -e \
@@ -27,7 +41,7 @@ An open source implementation of the Tailscale coordination server.
2741
3. Sort some stuff up (headscale Wireguard keys & the config.json file)
2842
```shell
2943
wg genkey > private.key
30-
wg pubkey < private.key > public.key # although not strictly needed
44+
wg pubkey < private.key > public.key # not needed
3145
cp config.json.example config.json
3246
```
3347

@@ -41,9 +55,17 @@ An open source implementation of the Tailscale coordination server.
4155
tailscale up -login-server YOUR_HEADSCALE_URL
4256
```
4357

44-
6. Navigate to the URL you will get with `tailscale up`, where you can find your machine key.
58+
6. Navigate to the URL you will get with `tailscale up`, where you'll find your machine key.
4559

4660
7. Register your machine using the headscale CLI
4761
```shell
4862
./headscale register YOURMACHINEKEY
4963
```
64+
65+
66+
## Disclaimer
67+
68+
1. I have nothing to do with Tailscale, or Tailscale Inc.
69+
2. The purpose of writing this was to learn how Tailscale works.
70+
3. I don't use Headscale myself.
71+

0 commit comments

Comments
 (0)