Browse Source

BBS: Add documentation.

tags/v1.1.4
lain 5 years ago
parent
commit
3fc4ea45df
2 changed files with 19 additions and 0 deletions
  1. +1
    -0
      .gitignore
  2. +18
    -0
      docs/config.md

+ 1
- 0
.gitignore View File

@@ -11,6 +11,7 @@
/test/tmp/
/doc
/instance
/priv/ssh_keys

# Prevent committing custom emojis
/priv/static/emoji/custom/*


+ 18
- 0
docs/config.md View File

@@ -356,3 +356,21 @@ Pleroma account will be created with the same name as the LDAP user name.

* `Pleroma.Web.Auth.PleromaAuthenticator`: default database authenticator
* `Pleroma.Web.Auth.LDAPAuthenticator`: LDAP authentication

## BBS / SSH access

To enable simple command line interface accessible over ssh, add a setting like this to your configuration file:

```exs
app_dir = File.cwd!
priv_dir = Path.join([app_dir, "priv/ssh_keys"])

config :esshd,
enabled: true,
priv_dir: priv_dir,
handler: "Pleroma.BBS.Handler",
port: 10_022,
password_authenticator: "Pleroma.BBS.Authenticator"
```

Feel free to adjust the priv_dir and port number. Then you will have to create the key for the keys (in the example `priv/ssh_keys`) and create the host keys with `ssh-keygen -N "" -b 2048 -t rsa -f ssh_host_rsa_key`. After restarting, you should be able to connect to your Pleroma instance with `ssh username@server -p $PORT`

Loading…
Cancel
Save