focalboard/website/site/content/guide/admin/_index.md

43 lines
1.7 KiB
Markdown
Raw Normal View History

2021-01-25 20:08:42 +01:00
---
title: "Administrator's Guide"
date: "2020-12-15T12:01:23-04:00"
section: "guide"
weight: 3
---
## Personal Server configuration
Personal Server settings are stored in `config.json` and is read when the server is launched. The contents are:
| Key | Description | Example |
| ----------- | ----------- | ---
| serverRoot | Root URL of the server | "http://localhost:8000"
| port | Server port | 8000
| dbtype | Type of database. `sqlite3` or `postgres` | "sqlite3"
2021-01-26 20:13:05 +01:00
| dbconfig | Database connection string | postgres://user:pass@localhost/boards?sslmode=disable&connect_timeout=10
2021-01-25 20:08:42 +01:00
| webpath | Path to web files | "./webapp/pack"
| filespath | Path to uploaded files folder | "./files"
| telemetry | Enable health diagnostics telemetry | true
| session_expire_time | Session expiration time in seconds | 2592000
| session_refresh_time | Session refresh time in seconds | 18000
| enableLocalMode | Enable Admin APIs on local Unix port | true
| localModeSocketLocation | Location of local Unix port | "/var/tmp/octo_local.socket"
## Resetting passwords
By default, Personal Server exposes admin APIs on a local Unix socket at `/var/tmp/octo_local.socket`. This is configurable by the `enableLocalMode` and `localModeSocketLocation` settings in config.json.
To reset a user's password, you can use the follwing `reset-password.sh` script:
```
#!/bin/bash
if [[ $# < 2 ]] ; then
echo 'reset-password.sh <username> <new password>'
exit 1
fi
curl --unix-socket /var/tmp/octo_local.socket http://localhost/api/v1/admin/users/$1/password -X POST -H 'Content-Type: application/json' -d '{ "password": "'$2'" }'
```