docker-compose.yml 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677
  1. version: '2'
  2. # Note: Do not add single quotes '' to variables. Having spaces still works without quotes where required.
  3. #---------------------------------------------------------------------------------------------------------
  4. # ==== CREATING USERS AND LOGGING IN TO WEKAN ====
  5. # https://github.com/wekan/wekan/wiki/Adding-users
  6. #---------------------------------------------------------------------------------------------------------
  7. # ==== FORGOT PASSWORD ====
  8. # https://github.com/wekan/wekan/wiki/Forgot-Password
  9. #---------------------------------------------------------------------------------------------------------
  10. # ==== Upgrading Wekan to new version =====
  11. # NOTE: MongoDB has changed from 3.x to 4.x, in that case you need backup/restore with --noIndexRestore
  12. # see https://github.com/wekan/wekan/wiki/Backup
  13. # 1) Stop Wekan:
  14. # docker-compose stop
  15. # 2) Remove old Wekan app (wekan-app only, not that wekan-db container that has all your data)
  16. # docker rm wekan-app
  17. # 3) Get newest docker-compose.yml from https://github.com/wekan/wekan to have correct image,
  18. # for example: "image: quay.io/wekan/wekan" or version tag "image: quay.io/wekan/wekan:v4.52"
  19. # 4) Start Wekan:
  20. # docker-compose up -d
  21. #----------------------------------------------------------------------------------
  22. # ==== OPTIONAL: DEDICATED DOCKER USER ====
  23. # 1) Optionally create a dedicated user for Wekan, for example:
  24. # sudo useradd -d /home/wekan -m -s /bin/bash wekan
  25. # 2) Add this user to the docker group, then logout+login or reboot:
  26. # sudo usermod -aG docker wekan
  27. # 3) Then login as user wekan.
  28. # 4) Create this file /home/wekan/docker-compose.yml with your modifications.
  29. #----------------------------------------------------------------------------------
  30. # ==== RUN DOCKER AS SERVICE ====
  31. # 1a) Running Docker as service, on Systemd like Debian 9, Ubuntu 16.04, CentOS 7:
  32. # sudo systemctl enable docker
  33. # sudo systemctl start docker
  34. # 1b) Running Docker as service, on init.d like Debian 8, Ubuntu 14.04, CentOS 6:
  35. # sudo update-rc.d docker defaults
  36. # sudo service docker start
  37. # ----------------------------------------------------------------------------------
  38. # ==== USAGE OF THIS docker-compose.yml ====
  39. # 1) For seeing does Wekan work, try this and check with your web browser:
  40. # docker-compose up
  41. # 2) Stop Wekan and start Wekan in background:
  42. # docker-compose stop
  43. # docker-compose up -d
  44. # 3) See running Docker containers:
  45. # docker ps
  46. # 4) Stop Docker containers:
  47. # docker-compose stop
  48. # ----------------------------------------------------------------------------------
  49. # ===== INSIDE DOCKER CONTAINERS, AND BACKUP/RESTORE ====
  50. # https://github.com/wekan/wekan/wiki/Backup
  51. # If really necessary, repair MongoDB: https://github.com/wekan/wekan-mongodb/issues/6#issuecomment-424004116
  52. # 1) Going inside containers:
  53. # a) Wekan app, does not contain data
  54. # docker exec -it wekan-app bash
  55. # b) MongoDB, contains all data
  56. # docker exec -it wekan-db bash
  57. # 2) Copying database to outside of container:
  58. # docker exec -it wekan-db bash
  59. # cd /data
  60. # mongodump
  61. # exit
  62. # docker cp wekan-db:/data/dump .
  63. # 3) Restoring database
  64. # # 1) Stop wekan
  65. # docker stop wekan-app
  66. # # 2) Go inside database container
  67. # docker exec -it wekan-db bash
  68. # # 3) and data directory
  69. # cd /data
  70. # # 4) Remove previos dump
  71. # rm -rf dump
  72. # # 5) Exit db container
  73. # exit
  74. # # 6) Copy dump to inside docker container
  75. # docker cp dump wekan-db:/data/
  76. # # 7) Go inside database container
  77. # docker exec -it wekan-db bash
  78. # # 8) and data directory
  79. # cd /data
  80. # # 9) Restore
  81. # mongorestore --drop
  82. # # 10) Exit db container
  83. # exit
  84. # # 11) Start wekan
  85. # docker start wekan-app
  86. #-------------------------------------------------------------------------
  87. services:
  88. wekandb:
  89. #-------------------------------------------------------------------------------------
  90. # ==== MONGODB AND METEOR VERSION ====
  91. # a) mongodb latest, like 3.2 - 4.4 or newer https://hub.docker.com/_/mongo?tab=description
  92. image: mongo:latest
  93. #-------------------------------------------------------------------------------------
  94. container_name: wekan-db
  95. restart: always
  96. command: mongod --oplogSize 128
  97. networks:
  98. - wekan-tier
  99. expose:
  100. - 27017
  101. volumes:
  102. - wekan-db:/data/db
  103. - wekan-db-dump:/dump
  104. wekan:
  105. #-------------------------------------------------------------------------------------
  106. # ==== MONGODB AND METEOR VERSION ====
  107. # a) Quay automatic builds do work, https://quay.io/wekan7wekan
  108. image: quay.io/wekan/wekan
  109. # b) Using specific version tag:
  110. # image: quay.io/wekan/wekan:v4.52
  111. # c) Docker Hub builds are broken with error ENOMEM https://hub.docker.com/r/wekanteam/wekan
  112. # image: wekanteam/wekan
  113. #-------------------------------------------------------------------------------------
  114. container_name: wekan-app
  115. restart: always
  116. networks:
  117. - wekan-tier
  118. #-------------------------------------------------------------------------------------
  119. # ==== BUILD wekan-app DOCKER CONTAINER FROM SOURCE, if you uncomment these ====
  120. # ==== and use commands: docker-compose up -d --build
  121. #build:
  122. # context: .
  123. # dockerfile: Dockerfile
  124. # args:
  125. # - NODE_VERSION=${NODE_VERSION}
  126. # - METEOR_RELEASE=${METEOR_RELEASE}
  127. # - NPM_VERSION=${NPM_VERSION}
  128. # - ARCHITECTURE=${ARCHITECTURE}
  129. # - SRC_PATH=${SRC_PATH}
  130. # - METEOR_EDGE=${METEOR_EDGE}
  131. # - USE_EDGE=${USE_EDGE}
  132. #-------------------------------------------------------------------------------------
  133. ports:
  134. # Docker outsideport:insideport. Do not add anything extra here.
  135. # For example, if you want to have wekan on port 3001,
  136. # use 3001:8080 . Do not add any extra address etc here, that way it does not work.
  137. # remove port mapping if you use nginx reverse proxy, port 8080 is already exposed to wekan-tier network
  138. - 80:8080
  139. environment:
  140. - MONGO_URL=mongodb://wekandb:27017/wekan
  141. #---------------------------------------------------------------
  142. # ==== ROOT_URL SETTING ====
  143. # Change ROOT_URL to your real Wekan URL, for example:
  144. # If you have Caddy/Nginx/Apache providing SSL
  145. # - https://example.com
  146. # - https://boards.example.com
  147. # This can be problematic with avatars https://github.com/wekan/wekan/issues/1776
  148. # - https://example.com/wekan
  149. # If without https, can be only wekan node, no need for Caddy/Nginx/Apache if you don't need them
  150. # - http://example.com
  151. # - http://boards.example.com
  152. # - http://192.168.1.100 <=== using at local LAN
  153. - ROOT_URL=http://localhost # <=== using only at same laptop/desktop where Wekan is installed
  154. #---------------------------------------------------------------
  155. # ==== EMAIL SETTINGS ====
  156. # Email settings are required in both MAIL_URL and Admin Panel,
  157. # see https://github.com/wekan/wekan/wiki/Troubleshooting-Mail
  158. # For SSL in email, change smtp:// to smtps://
  159. # NOTE: Special characters need to be url-encoded in MAIL_URL.
  160. # You can encode those characters for example at: https://www.urlencoder.org
  161. #- MAIL_URL=smtp://user:pass@mailserver.example.com:25/
  162. - MAIL_URL=smtp://<mail_url>:25/?ignoreTLS=true&tls={rejectUnauthorized:false}
  163. - MAIL_FROM=Wekan Notifications <noreply.wekan@mydomain.com>
  164. #---------------------------------------------------------------
  165. # ==== OPTIONAL: MONGO OPLOG SETTINGS =====
  166. # https://github.com/wekan/wekan-mongodb/issues/2#issuecomment-378343587
  167. # We've fixed our CPU usage problem today with an environment
  168. # change around Wekan. I wasn't aware during implementation
  169. # that if you're using more than 1 instance of Wekan
  170. # (or any MeteorJS based tool) you're supposed to set
  171. # MONGO_OPLOG_URL as an environment variable.
  172. # Without setting it, Meteor will perform a poll-and-diff
  173. # update of it's dataset. With it, Meteor will update from
  174. # the OPLOG. See here
  175. # https://blog.meteor.com/tuning-meteor-mongo-livedata-for-scalability-13fe9deb8908
  176. # After setting
  177. # MONGO_OPLOG_URL=mongodb://<username>:<password>@<mongoDbURL>/local?authSource=admin&replicaSet=rsWekan
  178. # the CPU usage for all Wekan instances dropped to an average
  179. # of less than 10% with only occasional spikes to high usage
  180. # (I guess when someone is doing a lot of work)
  181. # - MONGO_OPLOG_URL=mongodb://<username>:<password>@<mongoDbURL>/local?authSource=admin&replicaSet=rsWekan
  182. #---------------------------------------------------------------
  183. # ==== OPTIONAL: KADIRA PERFORMANCE MONITORING FOR METEOR ====
  184. # https://github.com/edemaine/kadira-compose
  185. # https://github.com/meteor/meteor-apm-agent
  186. # https://blog.meteor.com/kadira-apm-is-now-open-source-490469ffc85f
  187. #- APM_OPTIONS_ENDPOINT=http://<kadira-ip>:11011
  188. #- APM_APP_ID=
  189. #- APM_APP_SECRET=
  190. #---------------------------------------------------------------
  191. # ==== OPTIONAL: LOGS AND STATS ====
  192. # https://github.com/wekan/wekan/wiki/Logs
  193. #
  194. # Daily export of Wekan changes as JSON to Logstash and ElasticSearch / Kibana (ELK)
  195. # https://github.com/wekan/wekan-logstash
  196. #
  197. # Statistics Python script for Wekan Dashboard
  198. # https://github.com/wekan/wekan-stats
  199. #
  200. # Console, file, and zulip logger on database changes https://github.com/wekan/wekan/pull/1010
  201. # with fix to replace console.log by winston logger https://github.com/wekan/wekan/pull/1033
  202. # but there could be bug https://github.com/wekan/wekan/issues/1094
  203. #
  204. # There is Feature Request: Logging date and time of all activity with summary reports,
  205. # and requesting reason for changing card to other column https://github.com/wekan/wekan/issues/1598
  206. #---------------------------------------------------------------
  207. # ==== WEKAN API AND EXPORT BOARD ====
  208. # Wekan Export Board works when WITH_API=true.
  209. # https://github.com/wekan/wekan/wiki/REST-API
  210. # https://github.com/wekan/wekan-gogs
  211. # If you disable Wekan API with false, Export Board does not work.
  212. - WITH_API=true
  213. #---------------------------------------------------------------
  214. # ==== PASSWORD BRUTE FORCE PROTECTION ====
  215. #https://atmospherejs.com/lucasantoniassi/accounts-lockout
  216. #Defaults below. Uncomment to change. wekan/server/accounts-lockout.js
  217. #- ACCOUNTS_LOCKOUT_KNOWN_USERS_FAILURES_BEFORE=3
  218. #- ACCOUNTS_LOCKOUT_KNOWN_USERS_PERIOD=60
  219. #- ACCOUNTS_LOCKOUT_KNOWN_USERS_FAILURE_WINDOW=15
  220. #- ACCOUNTS_LOCKOUT_UNKNOWN_USERS_FAILURES_BERORE=3
  221. #- ACCOUNTS_LOCKOUT_UNKNOWN_USERS_LOCKOUT_PERIOD=60
  222. #- ACCOUNTS_LOCKOUT_UNKNOWN_USERS_FAILURE_WINDOW=15
  223. #---------------------------------------------------------------
  224. # ==== STORE ATTACHMENT ON SERVER FILESYSTEM INSTEAD OF MONGODB ====
  225. # https://github.com/wekan/wekan/pull/2603
  226. #- ATTACHMENTS_STORE_PATH = <pathname> # pathname can be relative or fullpath
  227. #---------------------------------------------------------------
  228. # ==== RICH TEXT EDITOR IN CARD COMMENTS ====
  229. # https://github.com/wekan/wekan/pull/2560
  230. - RICHER_CARD_COMMENT_EDITOR=false
  231. #---------------------------------------------------------------
  232. # ==== CARD OPENED, SEND WEBHOOK MESSAGE ====
  233. # https://github.com/wekan/wekan/issues/2518
  234. - CARD_OPENED_WEBHOOK_ENABLED=false
  235. #---------------------------------------------------------------
  236. # ==== Allow to shrink attached/pasted image ====
  237. # https://github.com/wekan/wekan/pull/2544
  238. #-MAX_IMAGE_PIXEL=1024
  239. #-IMAGE_COMPRESS_RATIO=80
  240. #---------------------------------------------------------------
  241. # ==== NOTIFICATION TRAY AFTER READ DAYS BEFORE REMOVE =====
  242. # Number of days after a notification is read before we remove it.
  243. # Default: 2
  244. #- NOTIFICATION_TRAY_AFTER_READ_DAYS_BEFORE_REMOVE=2
  245. #---------------------------------------------------------------
  246. # ==== BIGEVENTS DUE ETC NOTIFICATIONS =====
  247. # https://github.com/wekan/wekan/pull/2541
  248. # Introduced a system env var BIGEVENTS_PATTERN default as "NONE",
  249. # so any activityType matches the pattern, system will send out
  250. # notifications to all board members no matter they are watching
  251. # or tracking the board or not. Owner of the wekan server can
  252. # disable the feature by setting this variable to "NONE" or
  253. # change the pattern to any valid regex. i.e. '|' delimited
  254. # activityType names.
  255. # a) Example
  256. #- BIGEVENTS_PATTERN=due
  257. # b) All
  258. #- BIGEVENTS_PATTERN=received|start|due|end
  259. # c) Disabled
  260. - BIGEVENTS_PATTERN=NONE
  261. #---------------------------------------------------------------
  262. # ==== EMAIL DUE DATE NOTIFICATION =====
  263. # https://github.com/wekan/wekan/pull/2536
  264. # System timelines will be showing any user modification for
  265. # dueat startat endat receivedat, also notification to
  266. # the watchers and if any card is due, about due or past due.
  267. #
  268. # Notify due days, default is None, 2 days before and on the event day
  269. #- NOTIFY_DUE_DAYS_BEFORE_AND_AFTER=2,0
  270. #
  271. # Notify due at hour of day. Default every morning at 8am. Can be 0-23.
  272. # If env variable has parsing error, use default. Notification sent to watchers.
  273. #- NOTIFY_DUE_AT_HOUR_OF_DAY=8
  274. #-----------------------------------------------------------------
  275. # ==== EMAIL NOTIFICATION TIMEOUT, ms =====
  276. # Defaut: 30000 ms = 30s
  277. #- EMAIL_NOTIFICATION_TIMEOUT=30000
  278. #-----------------------------------------------------------------
  279. # ==== CORS =====
  280. # CORS: Set Access-Control-Allow-Origin header.
  281. #- CORS=*
  282. # CORS_ALLOW_HEADERS: Set Access-Control-Allow-Headers header. "Authorization,Content-Type" is required for cross-origin use of the API.
  283. #- CORS_ALLOW_HEADERS=Authorization,Content-Type
  284. # CORS_EXPOSE_HEADERS: Set Access-Control-Expose-Headers header. This is not needed for typical CORS situations
  285. #- CORS_EXPOSE_HEADERS=*
  286. #-----------------------------------------------------------------
  287. # ==== MATOMO INTEGRATION ====
  288. # Optional: Integration with Matomo https://matomo.org that is installed to your server
  289. # The address of the server where Matomo is hosted.
  290. #- MATOMO_ADDRESS=https://example.com/matomo
  291. # The value of the site ID given in Matomo server for Wekan
  292. #- MATOMO_SITE_ID=1
  293. # The option do not track which enables users to not be tracked by matomo
  294. #- MATOMO_DO_NOT_TRACK=true
  295. # The option that allows matomo to retrieve the username:
  296. #- MATOMO_WITH_USERNAME=true
  297. #-----------------------------------------------------------------
  298. # ==== BROWSER POLICY AND TRUSTED IFRAME URL ====
  299. # Enable browser policy and allow one trusted URL that can have iframe that has Wekan embedded inside.
  300. # Setting this to false is not recommended, it also disables all other browser policy protections
  301. # and allows all iframing etc. See wekan/server/policy.js
  302. - BROWSER_POLICY_ENABLED=true
  303. # When browser policy is enabled, HTML code at this Trusted URL can have iframe that embeds Wekan inside.
  304. #- TRUSTED_URL=https://intra.example.com
  305. #-----------------------------------------------------------------
  306. # ==== OUTGOING WEBHOOKS ====
  307. # What to send to Outgoing Webhook, or leave out. Example, that includes all that are default: cardId,listId,oldListId,boardId,comment,user,card,commentId .
  308. #- WEBHOOKS_ATTRIBUTES=cardId,listId,oldListId,boardId,comment,user,card,commentId
  309. #-----------------------------------------------------------------
  310. # ==== Debug OIDC OAuth2 etc ====
  311. #- DEBUG=true
  312. #-----------------------------------------------------------------
  313. # ==== OAUTH2 ORACLE on premise identity manager OIM ====
  314. #- ORACLE_OIM_ENABLED=true
  315. #-----------------------------------------------------------------
  316. # ==== OAUTH2 AZURE ====
  317. # https://github.com/wekan/wekan/wiki/Azure
  318. # 1) Register the application with Azure. Make sure you capture
  319. # the application ID as well as generate a secret key.
  320. # 2) Configure the environment variables. This differs slightly
  321. # by installation type, but make sure you have the following:
  322. #- OAUTH2_ENABLED=true
  323. # Optional OAuth2 CA Cert, see https://github.com/wekan/wekan/issues/3299
  324. #- OAUTH2_CA_CERT=ABCD1234
  325. # Use OAuth2 ADFS additional changes. Also needs OAUTH2_ENABLED=true setting.
  326. #- OAUTH2_ADFS_ENABLED=false
  327. # OAuth2 login style: popup or redirect.
  328. #- OAUTH2_LOGIN_STYLE=redirect
  329. # Application GUID captured during app registration:
  330. #- OAUTH2_CLIENT_ID=xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx
  331. # Secret key generated during app registration:
  332. #- OAUTH2_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  333. #- OAUTH2_SERVER_URL=https://login.microsoftonline.com/
  334. #- OAUTH2_AUTH_ENDPOINT=/oauth2/v2.0/authorize
  335. #- OAUTH2_USERINFO_ENDPOINT=https://graph.microsoft.com/oidc/userinfo
  336. #- OAUTH2_TOKEN_ENDPOINT=/oauth2/v2.0/token
  337. # The claim name you want to map to the unique ID field:
  338. #- OAUTH2_ID_MAP=email
  339. # The claim name you want to map to the username field:
  340. #- OAUTH2_USERNAME_MAP=email
  341. # The claim name you want to map to the full name field:
  342. #- OAUTH2_FULLNAME_MAP=name
  343. # Tthe claim name you want to map to the email field:
  344. #- OAUTH2_EMAIL_MAP=email
  345. #-----------------------------------------------------------------
  346. # ==== OAUTH2 Nextcloud ====
  347. # 1) Register the application with Nextcloud: https://your.nextcloud/index.php/settings/admin/security
  348. # Make sure you capture the application ID as well as generate a secret key.
  349. # Use https://your.wekan/_oauth/oidc for the redirect URI.
  350. # 2) Configure the environment variables. This differs slightly
  351. # by installation type, but make sure you have the following:
  352. #- OAUTH2_ENABLED=true
  353. # OAuth2 login style: popup or redirect.
  354. #- OAUTH2_LOGIN_STYLE=redirect
  355. # Application GUID captured during app registration:
  356. #- OAUTH2_CLIENT_ID=xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx
  357. # Secret key generated during app registration:
  358. #- OAUTH2_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  359. #- OAUTH2_SERVER_URL=https://your-nextcloud.tld
  360. #- OAUTH2_AUTH_ENDPOINT=/index.php/apps/oauth2/authorize
  361. #- OAUTH2_USERINFO_ENDPOINT=/ocs/v2.php/cloud/user?format=json
  362. #- OAUTH2_TOKEN_ENDPOINT=/index.php/apps/oauth2/api/v1/token
  363. # The claim name you want to map to the unique ID field:
  364. #- OAUTH2_ID_MAP=id
  365. # The claim name you want to map to the username field:
  366. #- OAUTH2_USERNAME_MAP=id
  367. # The claim name you want to map to the full name field:
  368. #- OAUTH2_FULLNAME_MAP=display-name
  369. # Tthe claim name you want to map to the email field:
  370. #- OAUTH2_EMAIL_MAP=email
  371. #-----------------------------------------------------------------
  372. # ==== OAUTH2 KEYCLOAK ====
  373. # https://github.com/wekan/wekan/wiki/Keycloak <== MAPPING INFO, REQUIRED
  374. #- OAUTH2_ENABLED=true
  375. # OAuth2 login style: popup or redirect.
  376. #- OAUTH2_LOGIN_STYLE=redirect
  377. #- OAUTH2_CLIENT_ID=<Keycloak create Client ID>
  378. #- OAUTH2_SERVER_URL=<Keycloak server name>/auth
  379. #- OAUTH2_AUTH_ENDPOINT=/realms/<keycloak realm>/protocol/openid-connect/auth
  380. #- OAUTH2_USERINFO_ENDPOINT=/realms/<keycloak realm>/protocol/openid-connect/userinfo
  381. #- OAUTH2_TOKEN_ENDPOINT=/realms/<keycloak realm>/protocol/openid-connect/token
  382. #- OAUTH2_SECRET=<keycloak client secret>
  383. #-----------------------------------------------------------------
  384. # ==== OAUTH2 DOORKEEPER ====
  385. # https://github.com/wekan/wekan/issues/1874
  386. # https://github.com/wekan/wekan/wiki/OAuth2
  387. # Enable the OAuth2 connection
  388. #- OAUTH2_ENABLED=true
  389. # OAuth2 docs: https://github.com/wekan/wekan/wiki/OAuth2
  390. # OAuth2 login style: popup or redirect.
  391. #- OAUTH2_LOGIN_STYLE=redirect
  392. # OAuth2 Client ID.
  393. #- OAUTH2_CLIENT_ID=abcde12345
  394. # OAuth2 Secret.
  395. #- OAUTH2_SECRET=54321abcde
  396. # OAuth2 Server URL.
  397. #- OAUTH2_SERVER_URL=https://chat.example.com
  398. # OAuth2 Authorization Endpoint.
  399. #- OAUTH2_AUTH_ENDPOINT=/oauth/authorize
  400. # OAuth2 Userinfo Endpoint.
  401. #- OAUTH2_USERINFO_ENDPOINT=/oauth/userinfo
  402. # OAuth2 Token Endpoint.
  403. #- OAUTH2_TOKEN_ENDPOINT=/oauth/token
  404. # OAUTH2 ID Token Whitelist Fields.
  405. #- OAUTH2_ID_TOKEN_WHITELIST_FIELDS=""
  406. # OAUTH2 Request Permissions.
  407. #- OAUTH2_REQUEST_PERMISSIONS=openid profile email
  408. # OAuth2 ID Mapping
  409. #- OAUTH2_ID_MAP=
  410. # OAuth2 Username Mapping
  411. #- OAUTH2_USERNAME_MAP=
  412. # OAuth2 Fullname Mapping
  413. #- OAUTH2_FULLNAME_MAP=
  414. # OAuth2 Email Mapping
  415. #- OAUTH2_EMAIL_MAP=
  416. #-----------------------------------------------------------------
  417. # ==== LDAP: UNCOMMENT ALL TO ENABLE LDAP ====
  418. # https://github.com/wekan/wekan/wiki/LDAP
  419. # For Snap settings see https://github.com/wekan/wekan-snap/wiki/Supported-settings-keys
  420. # Most settings work both on Snap and Docker below.
  421. # Note: Do not add single quotes '' to variables. Having spaces still works without quotes where required.
  422. #
  423. # The default authentication method used if a user does not exist to create and authenticate. Can be set as ldap.
  424. #- DEFAULT_AUTHENTICATION_METHOD=ldap
  425. #
  426. # Enable or not the connection by the LDAP
  427. #- LDAP_ENABLE=true
  428. #
  429. # The port of the LDAP server
  430. #- LDAP_PORT=389
  431. #
  432. # The host server for the LDAP server
  433. #- LDAP_HOST=localhost
  434. #
  435. # The base DN for the LDAP Tree
  436. #- LDAP_BASEDN=ou=user,dc=example,dc=org
  437. #
  438. # Fallback on the default authentication method
  439. #- LDAP_LOGIN_FALLBACK=false
  440. #
  441. # Reconnect to the server if the connection is lost
  442. #- LDAP_RECONNECT=true
  443. #
  444. # Overall timeout, in milliseconds
  445. #- LDAP_TIMEOUT=10000
  446. #
  447. # Specifies the timeout for idle LDAP connections in milliseconds
  448. #- LDAP_IDLE_TIMEOUT=10000
  449. #
  450. # Connection timeout, in milliseconds
  451. #- LDAP_CONNECT_TIMEOUT=10000
  452. #
  453. # If the LDAP needs a user account to search
  454. #- LDAP_AUTHENTIFICATION=true
  455. #
  456. # The search user DN - You need quotes when you have spaces in parameters
  457. # 2 examples:
  458. #- LDAP_AUTHENTIFICATION_USERDN="CN=ldap admin,CN=users,DC=domainmatter,DC=lan"
  459. #- LDAP_AUTHENTIFICATION_USERDN="CN=wekan_adm,OU=serviceaccounts,OU=admin,OU=prod,DC=mydomain,DC=com"
  460. #
  461. # The password for the search user
  462. #- LDAP_AUTHENTIFICATION_PASSWORD=pwd
  463. #
  464. # Enable logs for the module
  465. #- LDAP_LOG_ENABLED=true
  466. #
  467. # If the sync of the users should be done in the background
  468. #- LDAP_BACKGROUND_SYNC=false
  469. #
  470. # At which interval does the background task sync.
  471. # The format must be as specified in:
  472. # https://bunkat.github.io/later/parsers.html#text
  473. #- LDAP_BACKGROUND_SYNC_INTERVAL='every 1 hour'
  474. #
  475. #- LDAP_BACKGROUND_SYNC_KEEP_EXISTANT_USERS_UPDATED=false
  476. #
  477. #- LDAP_BACKGROUND_SYNC_IMPORT_NEW_USERS=false
  478. #
  479. # If using LDAPS: LDAP_ENCRYPTION=ssl
  480. #- LDAP_ENCRYPTION=false
  481. #
  482. # The certification for the LDAPS server. Certificate needs to be included in this docker-compose.yml file.
  483. #- LDAP_CA_CERT=-----BEGIN CERTIFICATE-----MIIE+G2FIdAgIC...-----END CERTIFICATE-----
  484. #
  485. # Reject Unauthorized Certificate
  486. #- LDAP_REJECT_UNAUTHORIZED=false
  487. #
  488. # Option to login to the LDAP server with the user's own username and password, instead of an administrator key. Default: false (use administrator key).
  489. #- LDAP_USER_AUTHENTICATION="true"
  490. #
  491. # Which field is used to find the user for the user authentication. Default: uid.
  492. #- LDAP_USER_AUTHENTICATION_FIELD="uid"
  493. #
  494. # Optional extra LDAP filters. Don't forget the outmost enclosing parentheses if needed
  495. #- LDAP_USER_SEARCH_FILTER=
  496. #
  497. # base (search only in the provided DN), one (search only in the provided DN and one level deep), or sub (search the whole subtree)
  498. #- LDAP_USER_SEARCH_SCOPE=one
  499. #
  500. # Which field is used to find the user, like uid / sAMAccountName
  501. #- LDAP_USER_SEARCH_FIELD=sAMAccountName
  502. #
  503. # Used for pagination (0=unlimited)
  504. #- LDAP_SEARCH_PAGE_SIZE=0
  505. #
  506. # The limit number of entries (0=unlimited)
  507. #- LDAP_SEARCH_SIZE_LIMIT=0
  508. #
  509. # Enable group filtering. Note the authenticated ldap user must be able to query all relevant group data with own login data from ldap.
  510. #- LDAP_GROUP_FILTER_ENABLE=false
  511. #
  512. # The object class for filtering. Example: group
  513. #- LDAP_GROUP_FILTER_OBJECTCLASS=
  514. #
  515. # The attribute of a group identifying it. Example: cn
  516. #- LDAP_GROUP_FILTER_GROUP_ID_ATTRIBUTE=
  517. #
  518. # The attribute inside a group object listing its members. Example: member
  519. #- LDAP_GROUP_FILTER_GROUP_MEMBER_ATTRIBUTE=
  520. #
  521. # The format of the value of LDAP_GROUP_FILTER_GROUP_MEMBER_ATTRIBUTE. Example: 'dn' if the users dn ist saved as value into the attribute.
  522. #- LDAP_GROUP_FILTER_GROUP_MEMBER_FORMAT=
  523. #
  524. # The group name (id) that matches all users.
  525. #- LDAP_GROUP_FILTER_GROUP_NAME=
  526. #
  527. # LDAP_UNIQUE_IDENTIFIER_FIELD : This field is sometimes class GUID (Globally Unique Identifier). Example: guid
  528. #- LDAP_UNIQUE_IDENTIFIER_FIELD=
  529. #
  530. # LDAP_UTF8_NAMES_SLUGIFY : Convert the username to utf8
  531. #- LDAP_UTF8_NAMES_SLUGIFY=true
  532. #
  533. # LDAP_USERNAME_FIELD : Which field contains the ldap username. username / sAMAccountName
  534. #- LDAP_USERNAME_FIELD=sAMAccountName
  535. #
  536. # LDAP_FULLNAME_FIELD : Which field contains the ldap fullname. fullname / sAMAccountName
  537. #- LDAP_FULLNAME_FIELD=fullname
  538. #
  539. #- LDAP_MERGE_EXISTING_USERS=false
  540. #
  541. # Allow existing account matching by e-mail address when username does not match
  542. #- LDAP_EMAIL_MATCH_ENABLE=true
  543. #
  544. # LDAP_EMAIL_MATCH_REQUIRE : require existing account matching by e-mail address when username does match
  545. #- LDAP_EMAIL_MATCH_REQUIRE=true
  546. #
  547. # LDAP_EMAIL_MATCH_VERIFIED : require existing account email address to be verified for matching
  548. #- LDAP_EMAIL_MATCH_VERIFIED=true
  549. #
  550. # LDAP_EMAIL_FIELD : which field contains the LDAP e-mail address
  551. #- LDAP_EMAIL_FIELD=mail
  552. #-----------------------------------------------------------------
  553. #- LDAP_SYNC_USER_DATA=false
  554. #
  555. #- LDAP_SYNC_USER_DATA_FIELDMAP={"cn":"name", "mail":"email"}
  556. #
  557. #- LDAP_SYNC_GROUP_ROLES=''
  558. #
  559. # The default domain of the ldap it is used to create email if the field is not map correctly with the LDAP_SYNC_USER_DATA_FIELDMAP
  560. # example :
  561. #- LDAP_DEFAULT_DOMAIN=mydomain.com
  562. #
  563. # Enable/Disable syncing of admin status based on ldap groups:
  564. #- LDAP_SYNC_ADMIN_STATUS=true
  565. #
  566. # Comma separated list of admin group names to sync.
  567. #- LDAP_SYNC_ADMIN_GROUPS=group1,group2
  568. #---------------------------------------------------------------------
  569. # Login to LDAP automatically with HTTP header.
  570. # In below example for siteminder, at right side of = is header name.
  571. #- HEADER_LOGIN_ID=HEADERUID
  572. #- HEADER_LOGIN_FIRSTNAME=HEADERFIRSTNAME
  573. #- HEADER_LOGIN_LASTNAME=HEADERLASTNAME
  574. #- HEADER_LOGIN_EMAIL=HEADEREMAILADDRESS
  575. #---------------------------------------------------------------------
  576. # ==== LOGOUT TIMER, probably does not work yet ====
  577. # LOGOUT_WITH_TIMER : Enables or not the option logout with timer
  578. # example : LOGOUT_WITH_TIMER=true
  579. #- LOGOUT_WITH_TIMER=
  580. #
  581. # LOGOUT_IN : The number of days
  582. # example : LOGOUT_IN=1
  583. #- LOGOUT_IN=
  584. #
  585. # LOGOUT_ON_HOURS : The number of hours
  586. # example : LOGOUT_ON_HOURS=9
  587. #- LOGOUT_ON_HOURS=
  588. #
  589. # LOGOUT_ON_MINUTES : The number of minutes
  590. # example : LOGOUT_ON_MINUTES=55
  591. #- LOGOUT_ON_MINUTES=
  592. #-------------------------------------------------------------------
  593. # Hide password login form
  594. # - PASSWORD_LOGIN_ENABLED=true
  595. #-------------------------------------------------------------------
  596. #- CAS_ENABLED=true
  597. #- CAS_BASE_URL=https://cas.example.com/cas
  598. #- CAS_LOGIN_URL=https://cas.example.com/login
  599. #- CAS_VALIDATE_URL=https://cas.example.com/cas/p3/serviceValidate
  600. #---------------------------------------------------------------------
  601. #- SAML_ENABLED=true
  602. #- SAML_PROVIDER=
  603. #- SAML_ENTRYPOINT=
  604. #- SAML_ISSUER=
  605. #- SAML_CERT=
  606. #- SAML_IDPSLO_REDIRECTURL=
  607. #- SAML_PRIVATE_KEYFILE=
  608. #- SAML_PUBLIC_CERTFILE=
  609. #- SAML_IDENTIFIER_FORMAT=
  610. #- SAML_LOCAL_PROFILE_MATCH_ATTRIBUTE=
  611. #- SAML_ATTRIBUTES=
  612. #---------------------------------------------------------------------
  613. depends_on:
  614. - wekandb
  615. #---------------------------------------------------------------------------------
  616. # ==== OPTIONAL: SHARE DATABASE TO OFFICE LAN AND REMOTE VPN ====
  617. # When using Wekan both at office LAN and remote VPN:
  618. # 1) Have above Wekan docker container config with LAN IP address
  619. # 2) Copy all of above wekan container config below, look above of this part above and all config below it,
  620. # before above depends_on: part:
  621. #
  622. # wekan:
  623. # #-------------------------------------------------------------------------------------
  624. # # ==== MONGODB AND METEOR VERSION ====
  625. # # a) For Wekan Meteor 1.8.x version at meteor-1.8 branch, .....
  626. #
  627. #
  628. # and change name to different name like wekan2 or wekanvpn, and change ROOT_URL to server VPN IP
  629. # address.
  630. # 3) This way both Wekan containers can use same MongoDB database
  631. # and see the same Wekan boards.
  632. # 4) You could also add 3rd Wekan container for 3rd network etc.
  633. # EXAMPLE:
  634. # wekan2:
  635. # ....COPY CONFIG FROM ABOVE TO HERE...
  636. # environment:
  637. # - ROOT_URL='http://10.10.10.10'
  638. # ...COPY CONFIG FROM ABOVE TO HERE...
  639. #---------------------------------------------------------------------------------
  640. # OPTIONAL NGINX CONFIG FOR REVERSE PROXY
  641. # nginx:
  642. # image: nginx
  643. # container_name: nginx
  644. # restart: always
  645. # networks:
  646. # - wekan-tier
  647. # depends_on:
  648. # - wekan
  649. # ports:
  650. # - 80:80
  651. # - 443:443
  652. # volumes:
  653. # - ./nginx/ssl:/etc/nginx/ssl/:ro
  654. # - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
  655. ## Alternative volume config:
  656. ## volumes:
  657. ## - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro
  658. ## - ./nginx/ssl/ssl.conf:/etc/nginx/conf.d/ssl/ssl.conf:ro
  659. ## - ./nginx/ssl/testvm-ehu.crt:/etc/nginx/conf.d/ssl/certs/mycert.crt:ro
  660. ## - ./nginx/ssl/testvm-ehu.key:/etc/nginx/conf.d/ssl/certs/mykey.key:ro
  661. ## - ./nginx/ssl/pphrase:/etc/nginx/conf.d/ssl/pphrase:ro
  662. volumes:
  663. wekan-db:
  664. driver: local
  665. wekan-db-dump:
  666. driver: local
  667. networks:
  668. wekan-tier:
  669. driver: bridge