lib.itmens/docs/configuration.md

85 lines
4.8 KiB
Markdown
Raw Normal View History

2024-06-05 21:53:02 -04:00
# Configuration
2022-12-13 16:33:58 -05:00
2024-06-17 16:37:37 -04:00
## Important settings you may want to change first
2022-12-13 16:33:58 -05:00
2024-06-17 16:37:37 -04:00
absolutely set these in `.env` before start the instance for the first time:
2024-06-17 16:37:37 -04:00
- `NEODB_SECRET_KEY` - 50 characters of random string, no white space
- `NEODB_SITE_NAME` - the name of your site
- `NEODB_SITE_DOMAIN` - the domain name of your site
2024-06-17 16:37:37 -04:00
**`NEODB_SECRET_KEY` and `NEODB_SITE_DOMAIN` must not be changed later.**
if you are doing debug or development:
2024-06-17 16:37:37 -04:00
- `NEODB_DEBUG` - True will turn on debug for both neodb and takahe, turn off relay, and reveal self as debug mode in nodeinfo (so peers won't try to run fedi search on this node)
- `NEODB_IMAGE` - the docker image to use, `neodb/neodb:edge` for the main branch
2023-07-04 17:21:17 -04:00
2024-06-17 16:37:37 -04:00
## Settings for customization
2024-06-16 13:25:26 -04:00
2024-06-17 16:37:37 -04:00
- `NEODB_SITE_LOGO`
- `NEODB_SITE_ICON`
- `NEODB_USER_ICON`
- `NEODB_SITE_INTRO`
- `NEODB_SITE_HEAD`
- `NEODB_SITE_DESCRIPTION`
2024-07-14 16:56:58 -04:00
- `NEODB_PREFERRED_LANGUAGES` - preferred languages when importing titles from 3rd party sites like TMDB and Steam, comma-separated list of ISO-639-1 two-letter codes, `en,zh` by default.
- `NEODB_FILTER_LANGUAGE_FOR_DISCOVER` - when set to `True`, `/discover/` will only show items with languages match one of `NEODB_PREFERRED_LANGUAGES`. `False` by default.
2024-06-18 09:19:51 -04:00
- `NEODB_SITE_LINKS` - a list of title and links to show in the footer, comma separated, e.g. `Feedback=https://discord.gg/8KweCuApaK,ToS=/pages/rules/`
2024-06-17 16:37:37 -04:00
- `NEODB_INVITE_ONLY` - `False` by default, set to `True` to require invite code(generated by `neodb-manage invite --create`) to register
- `NEODB_ENABLE_LOCAL_ONLY` - `False` by default, set to `True` to allow user to post marks as "local public"
- `NEODB_LOGIN_MASTODON_WHITELIST` - a list of Mastodon instances to allow login from, comma separated
- `NEODB_ADMIN_USERNAMES` - a list of usernames to be admin, comma separated, server restart is required to apply this setting after these users are registered.
- `NEODB_EMAIL_FROM` - the email address to send email from
- `NEODB_EMAIL_URL` - email sender configuration, e.g.
- `smtp://<username>:<password>@<host>:<port>`
- `smtp+tls://<username>:<password>@<host>:<port>`
- `smtp+ssl://<username>:<password>@<host>:<port>`
- `anymail://<anymail_backend_name>?<anymail_args>`, to send email via email service providers, see [anymail doc](https://anymail.dev/)
- `DISCORD_WEBHOOKS` - Discord channel to send notification about user submitted suggestion and changes, e.g. `suggest=https://discord.com/api/webhooks/123/abc,audit=https://discord.com/api/webhooks/123/def`
2022-12-13 16:33:58 -05:00
2024-06-17 16:37:37 -04:00
## Settings for Federation
- `NEODB_SEARCH_PEERS` is empty by default, which means NeoDB will search all known peers running production version of NeoDB when user look for items. This can be set to a comma-separated list of host names, so that NeoDB will only search those servers; or search no other peers if set to just `-`.
- `NEODB_DISABLE_DEFAULT_RELAY` is set to `False` by default, the server will send and receive public posts from `relay.neodb.net`.
2024-06-17 16:37:37 -04:00
`relay.neodb.net` is [open sourced](https://github.com/neodb-social/neodb-relay) and operated by NeoDB developers, it works like most ActivityPub relays except it only relays between NeoDB instances, it helps public information like catalogs and trends flow between NeoDB instances. You may set it to `True` if you don't want to relay public posts with other NeoDB instances.
## Settings for external item sources
- `SPOTIFY_API_KEY` - base64('CLIENT_ID:SECRET'), see [spotify doc](https://developer.spotify.com/documentation/web-api/tutorials/client-credentials-flow)
- `TMDB_API_V3_KEY` - API v3 key from [TMDB](https://developer.themoviedb.org/)
- `GOOGLE_API_KEY` - API key for [Google Books](https://developers.google.com/books/docs/v1/using)
- `DISCOGS_API_KEY` - personal access token from [Discogs](https://www.discogs.com/settings/developers)
- `IGDB_API_CLIENT_ID`, `IGDB_API_CLIENT_SECRET` - IGDB [keys](https://api-docs.igdb.com/)
2024-04-06 11:53:31 -04:00
2024-06-05 21:53:02 -04:00
## Other maintenance tasks
2024-04-06 11:53:31 -04:00
Add alias to your shell for easier access
```
alias neodb-manage='docker-compose --profile production run shell neodb-manage'
```
2024-06-05 21:53:02 -04:00
## Multiple instances on one server
2024-06-17 16:37:37 -04:00
It's possible to run multiple clusters in one host server with docker compose, as long as `NEODB_SITE_DOMAIN`, `NEODB_PORT` and `NEODB_DATA` are different.
2024-06-05 21:53:02 -04:00
## Scaling up
For high-traffic instance, spin up these configurations to a higher number, as long as the host server can handle them:
- `NEODB_WEB_WORKER_NUM`
- `NEODB_API_WORKER_NUM`
- `NEODB_RQ_WORKER_NUM`
- `TAKAHE_WEB_WORKER_NUM`
- `TAKAHE_STATOR_CONCURRENCY`
- `TAKAHE_STATOR_CONCURRENCY_PER_MODEL`
Further scaling up with multiple nodes (e.g. via Kubernetes) is beyond the scope of this document, but consider run db/redis/typesense separately, and then duplicate web/worker/stator containers as long as connections and mounts are properly configured; `migration` only runs once when start or upgrade, it should be kept that way.