1
Fork 0
mirror of https://github.com/wlinator/luminara.git synced 2024-10-02 20:43:12 +00:00
Lumi/README.md
2024-06-16 00:45:24 +02:00

53 lines
2.3 KiB
Markdown

# You can invite me with [this link](https://discord.com/oauth2/authorize?client_id=1038050427272429588&permissions=8&scope=bot). Thanks for using Lumi!
![Lumi art](https://git.wlinator.org/assets/img/logo.png)
## Self-host
**The next part of this README explains how to self-host Lumi, this allows you to host your own version of my code and
create a personalized Discord bot.**
**Note: because the `.slots` and `.blackjack` commands use custom (animated) emoji, these commands will break when you self-host Lumi. Please replace the ID values in `config/JSON/resources.json` with your own set of emotes.**
### Installation
#### Docker
Lumi comes containerized with essential components such as MariaDB, its core application, Adminer, and Dozzle. To ensure smooth operation of Dozzle, it's necessary to copy `users.yml.example` to `users.yml` and configure an authentication user as outlined in the file. Refer to the file for detailed instructions.
To install Lumi, run these commands:
```commandline
git clone https://gitlab.com/wlinator/racu && cd racu
```
Copy `.env.template` to `.env` and fill out the [variables](#environment-variables).
```commandline
docker compose up -d --build
```
Please note that it's highly recommended to establish a reverse proxy setup for Adminer and Dozzle, ensuring better security and accessibility.
- Adminer should be directed to port 8080.
- Dozzle should be mapped to port 8081.
#### Alternative
You can run Lumi without Docker, however I don't provide support or documentation for this. Here are some requirements to get you started.
- MariaDB server on port 3306.
- Python 3.11 with the [required pip packages](requirements.txt).
- See the environment variables in [docker-compose.yml](docker-compose.yml) and set them manually.
## Environment variables (.env)
- `TOKEN`: your Discord Bot Token, you can get this [here](https://discord.com/developers/applications).
- `DBX_*`: set these up if you want to make database backups to your Dropbox app.
- `MARIADB_USER`: the username for your MariaDB database.
- `MARIADB_PASSWORD`: the password for your database.
- `MARIADB_ROOT_PASSWORD`: can be ignored unless you have a specific use for it.
- `MARIADB_DATABASE`: the name of your database.
Other variables can be specified in `docker.compose.yml` (core)
---
Some icons used in Lumi are provided by [Icons8](https://icons8.com/).