dotling 0.9.0

A dotfiles management CLI — track, link, and sync your config files across machines
Documentation 
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# dotling vault

Manage the encryption vault.

## Usage

```sh
dotling vault <ACTION>
```

## Actions

### `dotling vault init`

Initialize a new vault with a password.

```sh
dotling vault init
```

You'll be prompted for a password (entered twice for confirmation). This creates the vault at `~/.dotling/vault/` with an encrypted identity secret.

### `dotling vault show`

Display vault status and location.

```sh
dotling vault show
```

Shows whether a vault exists and its location. Note: creation date is not currently displayed.

### `dotling vault export`

Export the vault as a portable encrypted bundle.

```sh
dotling vault export <PATH>
```

Creates a single encrypted file containing the vault config and identity secret. Use this to migrate your vault to a new machine.

### `dotling vault import`

Import a vault bundle.

```sh
dotling vault import <PATH>
```

Imports the vault from an encrypted bundle. You'll be prompted for the bundle's password. This overwrites any existing vault.

### `dotling vault change-password`

Change the vault password.

```sh
dotling vault change-password
```

You'll be prompted for the current password and a new password. The vault identity is re-encrypted with the new password.

## Examples

```sh
# Set up encryption for the first time
dotling vault init

# Check vault status
dotling vault show

# Migrate to a new machine
dotling vault export ~/vault.bundle
# ... copy vault.bundle to new machine ...
dotling vault import ~/vault.bundle

# Change your password
dotling vault change-password
```

## See also

- [Encryption](../encryption.md) — full encryption guide