1 Environment Variables
Raccoon edited this page 2017-02-26 16:52:11 +08:00

Environment variables (will overwrite other server configs)

variables example values description
NODE_ENV production or development set current environment (will apply corresponding settings in the config.json)
DEBUG true or false set debug mode, show more logs
HMD_DOMAIN hackmd.io domain name
HMD_URL_PATH hackmd sub url path, like www.example.com/<URL_PATH>
HMD_PORT 80 web app port
HMD_ALLOW_ORIGIN localhost, hackmd.io domain name whitelist (use comma to separate)
HMD_PROTOCOL_USESSL true or false set to use ssl protocol for resources path (only applied when domain is set)
HMD_URL_ADDPORT true or false set to add port on callback url (port 80 or 443 won't applied) (only applied when domain is set)
HMD_USECDN true or false set to use CDN resources or not (default is true)
HMD_ALLOW_ANONYMOUS true or false set to allow anonymous usage (default is true)
HMD_ALLOW_FREEURL true or false set to allow new note by accessing not exist note url
HMD_DEFAULT_PERMISSION freely, editable, limited, locked or private set notes default permission (only applied on signed users)
HMD_DB_URL mysql://localhost:3306/database set the db url
HMD_FACEBOOK_CLIENTID no example Facebook API client id
HMD_FACEBOOK_CLIENTSECRET no example Facebook API client secret
HMD_TWITTER_CONSUMERKEY no example Twitter API consumer key
HMD_TWITTER_CONSUMERSECRET no example Twitter API consumer secret
HMD_GITHUB_CLIENTID no example GitHub API client id
HMD_GITHUB_CLIENTSECRET no example GitHub API client secret
HMD_GITLAB_BASEURL no example GitLab authentication endpoint, set to use other endpoint than GitLab.com (optional)
HMD_GITLAB_CLIENTID no example GitLab API client id
HMD_GITLAB_CLIENTSECRET no example GitLab API client secret
HMD_DROPBOX_CLIENTID no example Dropbox API client id
HMD_DROPBOX_CLIENTSECRET no example Dropbox API client secret
HMD_GOOGLE_CLIENTID no example Google API client id
HMD_GOOGLE_CLIENTSECRET no example Google API client secret
HMD_LDAP_URL ldap://example.com url of LDAP server
HMD_LDAP_BINDDN no example bindDn for LDAP access
HMD_LDAP_BINDCREDENTIALS no example bindCredentials for LDAP access
HMD_LDAP_TOKENSECRET supersecretkey secret used for generating access/refresh tokens
HMD_LDAP_SEARCHBASE o=users,dc=example,dc=com LDAP directory to begin search from
HMD_LDAP_SEARCHFILTER (uid={{username}}) LDAP filter to search with
HMD_LDAP_SEARCHATTRIBUTES no example LDAP attributes to search with
HMD_LDAP_TLS_CA server-cert.pem, root.pem Root CA for LDAP TLS in PEM format (use comma to separate)
HMD_LDAP_PROVIDERNAME My institution Optional name to be displayed at login form indicating the LDAP provider
HMD_IMGUR_CLIENTID no example Imgur API client id
HMD_EMAIL true or false set to allow email signin
HMD_ALLOW_EMAIL_REGISTER true or false set to allow email register (only applied when email is set, default is true)
HMD_IMAGE_UPLOAD_TYPE imgur, s3 or filesystem Where to upload image. For S3, see our S3 Image Upload Guide
HMD_S3_ACCESS_KEY_ID no example AWS access key id
HMD_S3_SECRET_ACCESS_KEY no example AWS secret key
HMD_S3_REGION ap-northeast-1 AWS S3 region
HMD_S3_BUCKET no example AWS S3 bucket name