scripts/README.md
2024-07-26 20:27:29 -04:00

33 lines
922 B
Markdown

# scripts
_Utilities to manage the machine Spadinastan runs on._
## Setup
Scripts present in this repository are meant to be run via `pipx`.
## Usage
Ensure that `go-task` is installed and `task -l`!
## System configuration
Scripts used by the `task` command will expect certain configuration files to exist on the system.
A file should exist at `/etc/opt/spadinastan/common.env` to define general root locations for where application data and media will be stored.
```
# /etc/opt/common.env
# Storage for application configuration volumes.
APP_DATA_DIR=...
# Storage for media owned by applications, such as downloads.
STORAGE_DIR=...
```
## Per-app configuration
Each application expects to find an environment file under `/etc/opt/spadinastan/<application>.env`. This is passed to the container as an envfile on start.
If the container doesn't expect anything, the file should still be present but empty.