chore: add readme instructions

This commit is contained in:
azyrite 2025-03-11 17:11:42 +11:00
parent a517812c48
commit ef15653ad1
Signed by: azyrite
SSH key fingerprint: SHA256:YlQ5V4DtSbnuUxJxw4cwU7L9q8NbeAOAsK4NZWybTkM

29
README.md Normal file
View file

@ -0,0 +1,29 @@
# Placid Ticketing System
> Made for the Pacifica Discord server
This program has only been tested with **rustc 1.84.0** on x86_64. No cross-platform compatibilities are guaratneed.
# Configuration
A configuration file must be provided along with appropriate environment variables. By default, the program expects the config file to be at `$PWD/config.toml`, but this path can be overriden with then `CONFIG_PATH` environment variable.
## Environment Variables
`CONFIG_PATH` - Override the configuration file's location.
`DISCORD_TOKEN` - **Required**: The Discord token of the bot. Create a bot at [discord.dev](https://discord.dev).
`ENV` - **Required**: Set to 'production' or 'development'. Controls where commands are registered and the running of embedded database migrations.
`TEST_GUILD` - Only required if `ENV` is set to 'development'.
`DATABASE_URL` - **Required**: A PostgreSQL database URL in the format `postgres://username:password@host:port/database`
## Configuration File
See the existing example in this repository. This configuration file should be in toml and configures the exact channel and role IDs to use, which differ between servers and may change, so it is not hardcoded into the binary.
# Installation
Compile and place the binary somewhere. It is recommended to use a process manager such as `systemd` or to dockerize this software for easier deployment.