Configuration files are automatically generated on startup into the `./config` folder. You may change the mount in the `docker-compose.yml` file to a different location if you want to store the configuration files in a different location.
Even thought most configuration options come in yaml format, there are some optional configuration options that need to need to be set via environment variables.
<Alert variant="danger">
Even though snip should come with reasonable defaults and randomly generated
secrets, please check the configuration files in the `./config` directory.
</Alert>
### Environment Variables
Even thought most configuration options come in yaml format, there are some optional configuration options that need to need to be set via environment variables. You can set them in a `.env` file in the same directory as the `docker-compose.yml` file. The `.env` file is automatically loaded by Docker Compose.
##### Hostname and Port
As the services dont know on which port they are exposed to the internet and on which
hostname they are running, you need to set the `SNIP_HOSTNAME` and `SNIP_PORT` environment variables. This is mainly used to generate the correct URLs for
single sign on providers and for the email verification links.
single sign on providers and for the email verification links. If you are currently just testing the platform, you can omit them.
For example using a `.env` file:
```.env
SNIP_HOSTNAME=snip.example.com
SNIP_PORT=443
...
...
@@ -64,6 +68,14 @@ E.g. using a `.env` file:
TZ=America/New_York
```
#### Complete example `.env` file
```.env
SNIP_HOSTNAME=snip.example.com
SNIP_PORT=443
TZ=Europe/Berlin
```
##### SSL
By default we supply a self signed certificate for development and testing purposes. For production use, you should mount your certificates (`certificate.crt` and `certificate.key`)