Setting Up the Environment
How to set up your environment to use the server.
Please set some basic details of the server in the .env
file. You can find the .env.example
file in the root directory of the project.
Warning
Securing file-system access of the host is important. Please make sure that your custom certificate files,.env
, .env.idp
files etc. are not accessible to unauthorized users.You should also ensure unauthorized persons do not have access to the docker containers. Ensuring the host server is secured, is your responsibility.
Configuration
cp .env.example .env && nano .env
## HELP
# https://get.apis.de/docs/server/env/
## ABOUT
# This will be used to create the root business unit
# Do not use special characters
COMPANY_NAME=
## CDM HOST and PORT
# The hostname to access the server.
# Must not contain protocol such as https://
# Must not have port number
# Must not have trailing slash
# Example: cdm.example.com
CDM_HOST=localhost
# Just the port number; 443 recommended
# Default port is 443
CDM_PORT=443
## USE CUSTOM HTTPS CERTIFICATE FOR CDM-SERVER (PRIVATE-KEY)
# If you have a custom certificate (private-key), set this to true.
# You need to place the custom certificate in the same directory as your `docker-compose.yml` file (where you have downloaded CDM-Server).
# The certificate file name must be `cdm-server.pfx`
# For a false value, a self-signed certificate will be created and used for HTTPS.
# Please check [help docs for more information](https://get.apis.de/docs/server/https/).
# Default is false
USE_CUSTOM_CERT=false
### CUSTOM CERTIFICATE PASSWORD
# If you are using a custom certificate (`USE_CUSTOM_CERT=true`) and your certificate is password-protected, set the password here.
# Otherwise, leave it empty.
CUSTOM_CERT_PASS=
Example
COMPANY_NAME=APIS Informationtechnologien GmbH
CDM_HOST=cdm.apis.de
CDM_PORT=443
USE_CUSTOM_CERT=true
CUSTOM_CERT_PASS=supersecretpassword
COMPANY_NAME
This is the name of your company. It will be used to create the root business unit.
USE_CUSTOM_CERT
See HTTPS for more information.
Setup Up ID Provider (IdP)
After you are done setting up .env
, please head over to the IdP Docs to setup .env.idp
file.
Permissions for the DotEnv
Files
It is recommended that you do not allow other users in same server system to read the DotEnv
files as some of them can contain credentials.
You can try chmod 600
on all of them.