···1212Environment variables can be set in the _environment_ before run, but Lumina prefers them to be loaded from
1313`$LUMINAFOLDER/.env`.
14141515-| NAME | DEFAULT | FOR |
1616-| -------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------- |
1717-| `LUMINA_POSTGRES_PORT` | `5432` | The port to contact the database on. |
1818-| `LUMINA_POSTGRES_HOST` | `localhost` | The address to contact the database on. |
1919-| `LUMINA_POSTGRES_USERNAME` | `lumina` | The username to log in to the database with. |
2020-| `LUMINA_POSTGRES_PASSWORD` | - | The password to log in to the database with. If not set, Lumina will try without. |
2121-| `LUMINA_POSTGRES_DATABASE` | `lumina_config` | The database to use. |
2222-| `LUMINA_REDIS_URL` | `redis://127.0.0.1/` | Redis URL to connect to. |
2323-| `LUMINA_DB_SALT` | `sal` | The salting to use for some data on the database. |
2424-| `LUMINA_SERVER_PORT` | `8085` | Port for Lumina to accept HTTP requests on. |
2525-| `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`) |
2626-| `LUMINA_SERVER_HTTPS` | `false` | Whether to use 'https' rather than 'http' in links, etc. (please do!) |
2727-| `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 |
2828-| `LUMINA_SYNC_INTERVAL` | `30` | Specifies the interval between syncs. Minimum is 30. |
1515+| NAME | DEFAULT | FOR |
1616+| -------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
1717+| `DATABASE_URL` | Development: `postgres://lumina:lumina_pw@localhost:5432/lumina_config`, production: - | The Postgres database url to connect to. Overrides all `LUMINA_POSTGRES_*` values. |
1818+| `LUMINA_POSTGRES_PORT` | `5432` | The port to contact the database on. |
1919+| `LUMINA_POSTGRES_HOST` | `localhost` | The address to contact the database on. |
2020+| `LUMINA_POSTGRES_USERNAME` | `lumina` | The username to log in to the database with. |
2121+| `LUMINA_POSTGRES_PASSWORD` | - | The password to log in to the database with. If not set, Lumina will try without. |
2222+| `LUMINA_POSTGRES_DATABASE` | `lumina_config` | The database to use. |
2323+| `LUMINA_REDIS_URL` | `redis://127.0.0.1/` | Redis URL to connect to. |
2424+| `LUMINA_DB_SALT` | `sal` | The salting to use for some data on the database. |
2525+| `LUMINA_SERVER_PORT` | `8085` | Port for Lumina to accept HTTP requests on. |
2626+| `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`) |
2727+| `LUMINA_SERVER_HTTPS` | `false` | Whether to use 'https' rather than 'http' in links, etc. (please do!) |
2828+| `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 |
2929+| `LUMINA_SYNC_INTERVAL` | `30` | Specifies the interval between syncs. Minimum is 30. |
29303031## Development
31323232-During development, I use the following:
3333+### With Nix (preffered)
3434+3535+Use `flake.nix`, either using `direnv` (there's an `.envrc` file to do this!) or with `nix develop`.
3636+This gets you all the dependencies, including Just.
3737+3838+```sh
3939+just dev # Prepares your enviroment and builds/runs the server with file watching.
4040+```
4141+4242+### Without Nix
4343+4444+Make sure you have [mise-en-place](https://mise.jdx.dev/) and [Just](https://just.systems/) preinstalled.
33453446```sh
3547mise install # Installs mise deps
3636-mise run local-devel-prep # Because you'll need a database running somewhere.
3737-mise run local-devel-watch # Also doable without -watch, if you'd prefer.
4848+just dev # Prepares your enviroment and builds/runs the server with file watching.
3849```
39504040-When running Lumina server in devel mode, it automatically creates two accounts for you and one of those has an attached
5151+When running Lumina server in development mode, it automatically creates two accounts for you and one of those has an attached
4152post on the global timeline.
42534354| Username | Email | Password |