Skip to content

Commit 72a5a37

Browse files
authored
Document configuration (#32)
1 parent 9b376e8 commit 72a5a37

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,30 @@ Commands:
6464
There is also an experimental `grib` command line for quering bugs (issues),
6565
which has almost identical options.
6666

67+
## Configuring
68+
69+
Unless you already have a GerTTY config, here is how to configure the tool:
70+
71+
```yaml
72+
# ~/.config/gri/gri.yaml
73+
servers:
74+
- name: opendev # server 0, select it with '-s 0'
75+
url: https://review.opendev.org/
76+
- name: rdo # server 0, select it with '-s 1'
77+
url: https://review.rdoproject.org/r/
78+
auth-type: basic # needed only for old gerrit versions
79+
```
80+
81+
You may be surprised to observe that the credentials are not stored inside
82+
the same file. That is by design and the tool will load them from `~/.netrc`
83+
file, which is also the standard way to place network related credentials.
84+
85+
```ini
86+
# ~/.netrc
87+
# password is the token generated by gerrit on your user settings page
88+
machine review.rdoproject.org login jonhdoe password changeme
89+
```
90+
6791
## Contributing
6892

6993
Are you missing a feature, just check if there is a bug open for it and add

0 commit comments

Comments
 (0)