auberge 0.9.2

CLI tool for managing self-hosted infrastructure with Ansible
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# auberge headscale add-user

Create a user and generate a pre-auth key

## Synopsis

```bash
auberge headscale add-user [NAME] [OPTIONS]
```

## Alias

`auberge hs au`

## Description

Creates a Headscale user and immediately generates a pre-auth key for that user. The pre-auth key can be passed to `tailscale up --authkey` to connect nodes to your Headscale control plane without manual approval.

When run without arguments, prompts interactively for username and expiration.

## Options

| Option             | Description                                | Default            |
| ------------------ | ------------------------------------------ | ------------------ |
| `[NAME]`           | Username to create                         | Interactive prompt |
| `-e, --expiration` | Pre-auth key expiration (1h, 24h, 48h, 7d) | 24h                |
| `--host HOST`      | Target host running headscale              | Interactive prompt |

## Examples

```bash
# Interactive mode
auberge hs au

# Create user with all args
auberge hs au alice --expiration 48h --host myserver
```

## Output

Prints the pre-auth key and shareable setup instructions for iOS/Tailscale clients.

## Next Steps

After generating a pre-auth key, use it to connect nodes:

```bash
auberge config set tailscale_authkey <PRE_AUTH_KEY>
auberge config set tailscale_login_server https://hs.<your-domain>
auberge ansible run --tags tailscale
```

## Related Commands

- [auberge headscale list-users](list-users.md) - List registered users
- [auberge headscale list-nodes](list-nodes.md) - List connected nodes
- [auberge headscale remove-user](remove-user.md) - Remove a user

## See Also

- [Headscale](../../applications/networking/headscale.md)