Verified Commit bccb33f5 authored by Jakob Moser's avatar Jakob Moser
Browse files

Explain how to connect for administrative tasks

parent 3257c056
Loading
Loading
Loading
Loading

docs/administration.md

0 → 100644
+43 −0
Original line number Diff line number Diff line
# Common Administrative Tasks

## Prerequisite: Connect

```bash
ssh jakob@poolpaypi.local
```

We recommend to use Tmux to keep the application and SQL terminal open. To test your luck, try:

```bash
tmux a
```

If you are lucky, you will now see the Admin UI and probably an SQLite prompt split on the UI. If you are unlucky, you have to set Tmux up yourself:

```bash
tmux
```

Press <kbd>Ctrl</kbd>+<kbd>B</kbd>, <kbd>"</kbd> (that is, <kbd>Ctrl</kbd>+<kbd>B</kbd> first, release it, and then enter <kbd>"</kbd>) to split Tmux into two panels. In both panels, execute the following:

```bash
sudo su poolpay
cd /coli/poolpay
source venv/bin/activate
```

To switch between panels, you can use <kbd>Ctrl</kbd>+<kbd>B</kbd>, <kbd></kbd> and <kbd>Ctrl</kbd>+<kbd>B</kbd>, <kbd></kbd>. 

In the upper panel, run:

```bash
python3 -m poolpay.admin ui
```

You might need to enter the Vault password now.

In the lower panel, run:

```bash
sqlite3 instance/poolpay.db
```
 No newline at end of file