# Lumina(/peonies) server

> Notice:
> This repo is edited on [Codeberg](https://codeberg.org/strawmelonjuice/Lumina) and mirrorred
> on [My forge](https://git.strawmelonjuice.com/strawmelonjuice/Lumina) and [GitHub](https://github.com/strawmelonjuice/lumina). But
> you can still send in a PR!
> See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.

### Environment variables

Part of the configuration is loaded from the database, part of it in environment variables.
Environment variables can be set in the _environment_ before run, but Lumina prefers them to be loaded from
`$LUMINAFOLDER/.env`.

| NAME                       | DEFAULT              | FOR                                                                                                                        |
| -------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `LUMINA_POSTGRES_PORT`     | `5432`               | The port to contact the database on.                                                                                       |
| `LUMINA_POSTGRES_HOST`     | `localhost`          | The address to contact the database on.                                                                                    |
| `LUMINA_POSTGRES_USERNAME` | `lumina`             | The username to log in to the database with.                                                                               |
| `LUMINA_POSTGRES_PASSWORD` | -                    | The password to log in to the database with. If not set, Lumina will try without.                                          |
| `LUMINA_POSTGRES_DATABASE` | `lumina_config`      | The database to use.                                                                                                       |
| `LUMINA_REDIS_URL`         | `redis://127.0.0.1/` | Redis URL to connect to.                                                                                                   |
| `LUMINA_DB_SALT`           | `sal`                | The salting to use for some data on the database.                                                                          |
| `LUMINA_SERVER_PORT`       | `8085`               | Port for Lumina to accept HTTP requests on.                                                                                |
| `LUMINA_SERVER_ADDR`       | `127.0.0.1`          | Address for Lumina to accept HTTP requests on. (usually `127.0.0.1` or `0.0.0.0`)                                          |
| `LUMINA_SERVER_HTTPS`      | `false`              | Whether to use 'https' rather than 'http' in links, etc. (please do!)                                                      |
| `LUMINA_SYNC_IID`          | `localhost`          | A name Lumina uses when communicating with other instances, must be equal to where it's http is facing the public internet |
| `LUMINA_SYNC_INTERVAL`     | `30`                 | Specifies the interval between syncs. Minimum is 30.                                                                       |

## Development

During development, I use the following:

```sh
mise install # Installs mise deps
mise run local-devel-prep # Because you'll need a database running somewhere.
mise run local-devel-watch # Also doable without -watch, if you'd prefer.
```

When running Lumina server in devel mode, it automatically creates two accounts for you and one of those has an attached
post on the global timeline.

| Username  | Email             | Password         |
| --------- | ----------------- | ---------------- |
| testuser1 | test@lumina123.co | MyTestPassw9292! |
| testuser2 | test@lumina234.co | MyTestPassw9292! |