add: README
This commit is contained in:
commit
9ea8fa8167
55
README.md
Normal file
55
README.md
Normal file
@ -0,0 +1,55 @@
|
||||
# zine API
|
||||
API server for all **zine** services.
|
||||
## Installation
|
||||
|
||||
1. [Install Rust](https://www.rust-lang.org/tools/install)
|
||||
2. Clone this repository
|
||||
3. Create `.env` file and edit your environment variables
|
||||
4. Fetch required dependencies
|
||||
```sh
|
||||
cargo fetch
|
||||
```
|
||||
5. Run application
|
||||
```sh
|
||||
cargo run
|
||||
```
|
||||
## Environment variables
|
||||
|
||||
To run this project, you will need to add the following environment variables to your .env file
|
||||
|
||||
- General
|
||||
| Variable name | Description | Default | Required |
|
||||
| -- | -- | -- | -- |
|
||||
| `HOST` | API host | 127.0.0.1 | false
|
||||
| `PORT` | Port to listen to | 8080 | false
|
||||
| `LOG_LEVEL` | Logging level (e.g. `INFO`, `WARN`, `ERROR`) | `INFO` | false
|
||||
|
||||
- Database
|
||||
| Variable name | Description | Default | Required |
|
||||
| -- | -- | -- | -- |
|
||||
| `DATABASE_URI` | PostgreSQL database URI | | true
|
||||
|
||||
alternative solution:
|
||||
| Variable name | Description | Default | Required |
|
||||
| -- | -- | -- | -- |
|
||||
| `DATABASE_HOST` | PostgreSQL database host | 127.0.0.1 | false
|
||||
| `DATABASE_PORT` | PostgreSQL database port | 5432 | false
|
||||
| `DATABASE_USER` | PostgreSQL database user | postgres | false
|
||||
| `DATABASE_PASSWORD` | PostgreSQL database password | "" | false
|
||||
|
||||
> **Note**
|
||||
>
|
||||
> If provided, `DATABASE_URI` will **always** take precedence over `DATABASE_{HOST, PORT, USER, PASSWORD}`.
|
||||
## Documentation
|
||||
|
||||
If you want to get some informations about our API, just see our [wiki](https://git.sador.me/zine/api/wiki)!
|
||||
## Feedback
|
||||
|
||||
If you have any feedback, issue with our app, or anything related to our app, please reach out to us at **zine@sador.me**.
|
||||
## License
|
||||
|
||||
[MIT](https://choosealicense.com/licenses/mit/)
|
||||
## Authors & contributors
|
||||
|
||||
- [@sadorowo](https://git.sador.me/sadorowo)
|
||||
|
Loading…
Reference in New Issue
Block a user