scripts/README.md

34 lines
922 B
Markdown
Raw Normal View History

2024-05-02 03:11:10 +00:00
# scripts
2024-07-06 19:52:06 +00:00
_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.