auberge 0.15.3

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

# auberge host edit

Edit host configuration interactively

## Synopsis

```bash
auberge host edit [NAME]
# Alias: auberge h e
```

## Description

Opens an interactive prompt to edit an existing host's configuration. Allows updating address, user, port, SSH key, tags, and description.

If `NAME` is omitted, you'll be prompted to select a host.

Note: Host name cannot be changed through this command — the name is a foreign key into the key directory layout, the remote hostname, and restic snapshot grouping. Use [`auberge host rename`](rename.md), which migrates all three.

## Arguments

| Argument | Description                             |
| -------- | --------------------------------------- |
| NAME     | Host name to edit (omit to be prompted) |

## Editable Fields

- **Address**: Host address (IP or hostname)
- **User**: SSH user
- **Port**: SSH port
- **SSH key**: Private key path, pre-filled with the current value (clear it to use the derived default `~/.ssh/identities/{hostname}/{user}`)
- **Tags**: Comma-separated tags
- **Description**: Host description

## Examples

```bash
# Edit host configuration
auberge host edit myserver

# Interactive (prompts for host)
auberge host edit
```

## Interactive Session Example

```
Host address [192.168.1.10]: 192.168.1.20
SSH user [ansible]: deploy
SSH port [2222]: 22
SSH key (empty for derived default): ~/.ssh/identities/myserver/deploy
Tags (comma-separated) [production, web]: production, api
Description [Production web server]: Main API server
✓ Host 'myserver' updated
```