artemis/docs/prod.md

35 lines
2.2 KiB
Markdown
Raw Permalink Normal View History

2023-03-02 16:47:40 +00:00
# ARTEMiS Production mode
2024-01-11 17:08:22 +00:00
ARTEMiS is designed to run in one of two ways. Developmen/local mode, which assumes you're just trying to set up something to save your scores and make the games work, and have patched your games to disable SSL and cert checks and encryption and the like, and production mode. In production mode, artemis assumes you have a proxy server, such as nginx or apache, standing in front of artemis doing HTTPS and port management. This document will cover how to properly set up a production instance of ARTEMiS.
2023-03-02 16:47:40 +00:00
2024-01-11 17:08:22 +00:00
## ARTEMiS configuration
Step 1 is to edit your artemis configuration. Some recomended changes:
### `server`
- `listen_address` -> `127.0.0.1`
- `is_develop` -> `False`
- `is_using_proxy` -> `True`
- `port` -> The port nginx will send proxied requests to. If you're using the example config, set this to 8080.
- `proxy_port` -> The port your proxy will be accepting title server connections on. If you're using the example config, set this to 80.
- `proxy_port_ssl` -> The port your proxy will be accepting secure title server connections on. If you're using the example config, set this to 443.
- `allow_unregistered_serials` -> `False`
### `billing`
- `standalone` -> `False`
2024-01-14 22:46:52 +00:00
### `allnet`
- `standalone` -> `False`
2024-01-11 17:08:22 +00:00
### `frontend`
- `enable` -> `True` if you want the frontend
2024-01-14 22:46:52 +00:00
- `port` -> `8090` if you're using the default nginx config, otherwise whatever port your proxy will be sending requests to
### `aimedb`
- `listen_address` -> `0.0.0.0` unless you're proxying aimedb requests (not recomended at this time), in which case, leave this option unchanged
2024-01-11 17:08:22 +00:00
If you plan to serve artemis behind a VPN, these additional settings are also recomended
- `check_arcade_ip` -> `True`
- `strict_ip_checking` -> `True`
2023-03-02 16:47:40 +00:00
2024-01-11 17:08:22 +00:00
## Nginx Configuration
For most cases, the config in `example_config` will suffice. It makes the following assumptions
- ARTEMiS is running on port 8080
- Billing is set to not be standalone
- You're not using cloudflare in front of your frontend
2023-03-02 16:47:40 +00:00
2024-01-11 17:08:22 +00:00
If this describes you, your only configuration needs are to edit the `server_name` and `certificate_*` directives. Otherwise, please see nginx configuration documentation to configure it to best suit your setup.