Lumina(/peonies) server

Requirements

The Gleam compiler, Erlang and rebar3
A MySQL/MariaDB database (or a SQLite one if you want to be QD!)
The Bun TypeScript ecosystem

Running Lumina

Clone it!

git clone https://github.com/strawmelonjuice/lumina.git

Run it!

Warning ya -- Lumina loads and logs in $HOME/.luminainstance/ unless specified otherwise as argument. If you'd like to keep it in the workspace, use:

bun run dev start-in ./

otherwise, just use bun run dev or bun run build && gleam start and have Lumina start in its default.

Environment variables

Part of the configuration is loaded from the MySQL 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_DB_TYPE_`	`"sqlite"` (not recommended for production)	The kind of database to use. Options are `mysql` or `sqlite`. OPTIONS: With SQLite: - `_LUMINA_SQLITE_FILE_` `"instance.sqlite"` SQLite file to connect to. Always a relative path from the instance folder. With MySQL: - `_LUMINA_MYSQL_PORT_` `"3306"` The port to contact the database on. - `_LUMINA_MYSQL_HOST_` `"localhost"` The address to contact the database on. - `_LUMINA_MYSQL_USERNAME_` `"lumina"` The username to log in to the database with. - `_LUMINA_MYSQL_PASSWORD_` (none) The password to log in to the database with. If not set, Lumina will try without. - `_LUMINA_MYSQL_DATABASE_` `"lumina_config"` The database to use.
`_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_`	`"localhost"`	Address for Lumina to accept HTTP requests on.
`_LUMINA_SERVER_HTTPS_`	`"false"`	Wether to use 'https' rather than 'http' in links, etc. (please do!)
`_LUMINA_SYNCHRONISATION_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_SYNCHRONISATION_INTERVAL_`	`"30"`	Specifies the interval between syncs. Minimum is 30.