docker-compose.yml 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773
  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 previous 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. # 2020-12-03:
  93. # - Mongo image copied from Docker Hub mongo:4.4.2-bionic to Quay
  94. # to avoid Docker Hub rate limits.
  95. # Quay image does work:
  96. # image: quay.io/wekan/mongo:4.4.2-bionic
  97. # Docker Hub MongoDB image does work:
  98. image: mongo:6
  99. #-------------------------------------------------------------------------------------
  100. container_name: wekan-db
  101. restart: always
  102. # command: mongod --oplogSize 128
  103. # Syslog: mongod --syslog --oplogSize 128 --quiet
  104. # Disable MongoDB logs:
  105. command: mongod --logpath /dev/null --oplogSize 128 --quiet
  106. networks:
  107. - wekan-tier
  108. expose:
  109. - 27017
  110. volumes:
  111. - /etc/localtime:/etc/localtime:ro
  112. - /etc/timezone:/etc/timezone:ro
  113. - wekan-db:/data/db
  114. - wekan-db-dump:/dump
  115. wekan:
  116. #-------------------------------------------------------------------------------------
  117. # ==== MONGODB AND METEOR VERSION ====
  118. # a) Quay automatic builds do work work, https://quay.io/wekan/wekan
  119. image: quay.io/wekan/wekan
  120. # b) Using specific version tag:
  121. # image: quay.io/wekan/wekan:v4.52
  122. # c) Docker Hub builds do work https://hub.docker.com/r/wekanteam/wekan
  123. # image: wekanteam/wekan
  124. #-------------------------------------------------------------------------------------
  125. container_name: wekan-app
  126. # On CentOS 7 there is seccomp issue with glibc 6,
  127. # so CentOS 7 users shoud use these security_opt seccomp:unconfined
  128. # settings to get WeKan working. See:
  129. # - https://github.com/wekan/wekan/issues/4585
  130. # - https://github.com/wekan/wekan/issues/4587
  131. #security_opt:
  132. # - seccomp:unconfined
  133. restart: always
  134. networks:
  135. - wekan-tier
  136. #-------------------------------------------------------------------------------------
  137. # ==== BUILD wekan-app DOCKER CONTAINER FROM SOURCE, if you uncomment these ====
  138. # ==== and use commands: docker-compose up -d --build
  139. #build:
  140. # context: .
  141. # dockerfile: Dockerfile
  142. #-------------------------------------------------------------------------------------
  143. ports:
  144. # Docker outsideport:insideport. Do not add anything extra here.
  145. # For example, if you want to have wekan on port 3001,
  146. # use 3001:8080 . Do not add any extra address etc here, that way it does not work.
  147. # remove port mapping if you use nginx reverse proxy, port 8080 is already exposed to wekan-tier network
  148. - 80:8080
  149. environment:
  150. #-----------------------------------------------------------------
  151. # ==== WRITEABLE PATH FOR FILE UPLOADS ====
  152. - WRITABLE_PATH=/data
  153. #-----------------------------------------------------------------
  154. # ==== AWS S3 FOR FILES ====
  155. # Any region. For example:
  156. # us-standard,us-west-1,us-west-2,
  157. # eu-west-1,eu-central-1,
  158. # ap-southeast-1,ap-northeast-1,sa-east-1
  159. #
  160. #- S3='{"s3":{"key": "xxx", "secret": "xxx", "bucket": "xxx", "region": "xxx"}}'
  161. #-----------------------------------------------------------------
  162. # ==== MONGO_URL ====
  163. - MONGO_URL=mongodb://wekandb:27017/wekan
  164. #---------------------------------------------------------------
  165. # ==== ROOT_URL SETTING ====
  166. # Change ROOT_URL to your real Wekan URL, for example:
  167. # If you have Caddy/Nginx/Apache providing SSL
  168. # - https://example.com
  169. # - https://boards.example.com
  170. # This can be problematic with avatars https://github.com/wekan/wekan/issues/1776
  171. # - https://example.com/wekan
  172. # If without https, can be only wekan node, no need for Caddy/Nginx/Apache if you don't need them
  173. # - http://example.com
  174. # - http://boards.example.com
  175. # - http://192.168.1.100 <=== using at local LAN
  176. - ROOT_URL=http://localhost # <=== using only at same laptop/desktop where Wekan is installed
  177. #---------------------------------------------------------------
  178. # ==== EMAIL SETTINGS ====
  179. # Email settings are only at MAIL_URL and MAIL_FROM.
  180. # Admin Panel has test button, but it's not used for settings.
  181. # see https://github.com/wekan/wekan/wiki/Troubleshooting-Mail
  182. # For SSL in email, change smtp:// to smtps://
  183. # NOTE: Special characters need to be url-encoded in MAIL_URL.
  184. # You can encode those characters for example at: https://www.urlencoder.org
  185. #- MAIL_URL=smtp://user:pass@mailserver.example.com:25/
  186. - MAIL_URL=smtp://<mail_url>:25/?ignoreTLS=true&tls={rejectUnauthorized:false}
  187. - MAIL_FROM=Wekan Notifications <noreply.wekan@mydomain.com>
  188. # Currently MAIL_SERVICE is not in use.
  189. #- MAIL_SERVICE=Outlook365
  190. #- MAIL_SERVICE_USER=firstname.lastname@hotmail.com
  191. #- MAIL_SERVICE_PASSWORD=SecretPassword
  192. #---------------------------------------------------------------
  193. # https://github.com/wekan/wekan/issues/3585#issuecomment-1021522132
  194. # Add more Node heap, this is done by default at Dockerfile:
  195. # - NODE_OPTIONS="--max_old_space_size=4096"
  196. # Add more stack, this is done at Dockerfile:
  197. # bash -c "ulimit -s 65500; exec node --stack-size=65500 main.js"
  198. #---------------------------------------------------------------
  199. # ==== OPTIONAL: MONGO OPLOG SETTINGS =====
  200. # https://github.com/wekan/wekan-mongodb/issues/2#issuecomment-378343587
  201. # We've fixed our CPU usage problem today with an environment
  202. # change around Wekan. I wasn't aware during implementation
  203. # that if you're using more than 1 instance of Wekan
  204. # (or any MeteorJS based tool) you're supposed to set
  205. # MONGO_OPLOG_URL as an environment variable.
  206. # Without setting it, Meteor will perform a poll-and-diff
  207. # update of it's dataset. With it, Meteor will update from
  208. # the OPLOG. See here
  209. # https://blog.meteor.com/tuning-meteor-mongo-livedata-for-scalability-13fe9deb8908
  210. # After setting
  211. # MONGO_OPLOG_URL=mongodb://<username>:<password>@<mongoDbURL>/local?authSource=admin&replicaSet=rsWekan
  212. # the CPU usage for all Wekan instances dropped to an average
  213. # of less than 10% with only occasional spikes to high usage
  214. # (I guess when someone is doing a lot of work)
  215. # - MONGO_OPLOG_URL=mongodb://<username>:<password>@<mongoDbURL>/local?authSource=admin&replicaSet=rsWekan
  216. #---------------------------------------------------------------
  217. # ==== OPTIONAL: KADIRA PERFORMANCE MONITORING FOR METEOR ====
  218. # https://github.com/edemaine/kadira-compose
  219. # https://github.com/meteor/meteor-apm-agent
  220. # https://blog.meteor.com/kadira-apm-is-now-open-source-490469ffc85f
  221. #- APM_OPTIONS_ENDPOINT=http://<kadira-ip>:11011
  222. #- APM_APP_ID=
  223. #- APM_APP_SECRET=
  224. #---------------------------------------------------------------
  225. # ==== OPTIONAL: LOGS AND STATS ====
  226. # https://github.com/wekan/wekan/wiki/Logs
  227. #
  228. # Daily export of Wekan changes as JSON to Logstash and ElasticSearch / Kibana (ELK)
  229. # https://github.com/wekan/wekan-logstash
  230. #
  231. # Statistics Python script for Wekan Dashboard
  232. # https://github.com/wekan/wekan-stats
  233. #
  234. # Console, file, and zulip logger on database changes https://github.com/wekan/wekan/pull/1010
  235. # with fix to replace console.log by winston logger https://github.com/wekan/wekan/pull/1033
  236. # but there could be bug https://github.com/wekan/wekan/issues/1094
  237. #
  238. # There is Feature Request: Logging date and time of all activity with summary reports,
  239. # and requesting reason for changing card to other column https://github.com/wekan/wekan/issues/1598
  240. #---------------------------------------------------------------
  241. # ==== NUMBER OF SEARCH RESULTS PER PAGE BY DEFAULT ====
  242. #- RESULTS_PER_PAGE=20
  243. #---------------------------------------------------------------
  244. # ==== WEKAN API AND EXPORT BOARD ====
  245. # Wekan Export Board works when WITH_API=true.
  246. # https://github.com/wekan/wekan/wiki/REST-API
  247. # https://github.com/wekan/wekan-gogs
  248. # If you disable Wekan API with false, Export Board does not work.
  249. - WITH_API=true
  250. #---------------------------------------------------------------
  251. # ==== PASSWORD BRUTE FORCE PROTECTION ====
  252. #https://atmospherejs.com/lucasantoniassi/accounts-lockout
  253. #Defaults below. Uncomment to change. wekan/server/accounts-lockout.js
  254. #- ACCOUNTS_LOCKOUT_KNOWN_USERS_FAILURES_BEFORE=3
  255. #- ACCOUNTS_LOCKOUT_KNOWN_USERS_PERIOD=60
  256. #- ACCOUNTS_LOCKOUT_KNOWN_USERS_FAILURE_WINDOW=15
  257. #- ACCOUNTS_LOCKOUT_UNKNOWN_USERS_FAILURES_BERORE=3
  258. #- ACCOUNTS_LOCKOUT_UNKNOWN_USERS_LOCKOUT_PERIOD=60
  259. #- ACCOUNTS_LOCKOUT_UNKNOWN_USERS_FAILURE_WINDOW=15
  260. #---------------------------------------------------------------
  261. # ==== ACCOUNT OPTIONS ====
  262. # https://docs.meteor.com/api/accounts-multi.html#AccountsCommon-config
  263. # Defaults below. Uncomment to change. wekan/server/accounts-common.js
  264. # - ACCOUNTS_COMMON_LOGIN_EXPIRATION_IN_DAYS=90
  265. #---------------------------------------------------------------
  266. # ==== RICH TEXT EDITOR IN CARD COMMENTS ====
  267. # https://github.com/wekan/wekan/pull/2560
  268. - RICHER_CARD_COMMENT_EDITOR=false
  269. #---------------------------------------------------------------
  270. # ==== CARD OPENED, SEND WEBHOOK MESSAGE ====
  271. # https://github.com/wekan/wekan/issues/2518
  272. - CARD_OPENED_WEBHOOK_ENABLED=false
  273. #---------------------------------------------------------------
  274. # ==== Allow configuration to validate uploaded attachments ====
  275. #-ATTACHMENTS_UPLOAD_EXTERNAL_PROGRAM=/usr/local/bin/avscan {file}
  276. #-ATTACHMENTS_UPLOAD_MIME_TYPES=image/*,text/*
  277. #-ATTACHMENTS_UPLOAD_MAX_SIZE=5000000
  278. #---------------------------------------------------------------
  279. # ==== Allow configuration to validate uploaded avatars ====
  280. #-AVATARS_UPLOAD_EXTERNAL_PROGRAM=/usr/local/bin/avscan {file}
  281. #-AVATARS_UPLOAD_MIME_TYPES=image/*
  282. #-AVATARS_UPLOAD_MAX_SIZE=500000
  283. #---------------------------------------------------------------
  284. # ==== Allow to shrink attached/pasted image ====
  285. # https://github.com/wekan/wekan/pull/2544
  286. #-MAX_IMAGE_PIXEL=1024
  287. #-IMAGE_COMPRESS_RATIO=80
  288. #---------------------------------------------------------------
  289. # ==== NOTIFICATION TRAY AFTER READ DAYS BEFORE REMOVE =====
  290. # Number of days after a notification is read before we remove it.
  291. # Default: 2
  292. #- NOTIFICATION_TRAY_AFTER_READ_DAYS_BEFORE_REMOVE=2
  293. #---------------------------------------------------------------
  294. # ==== BIGEVENTS DUE ETC NOTIFICATIONS =====
  295. # https://github.com/wekan/wekan/pull/2541
  296. # Introduced a system env var BIGEVENTS_PATTERN default as "NONE",
  297. # so any activityType matches the pattern, system will send out
  298. # notifications to all board members no matter they are watching
  299. # or tracking the board or not. Owner of the wekan server can
  300. # disable the feature by setting this variable to "NONE" or
  301. # change the pattern to any valid regex. i.e. '|' delimited
  302. # activityType names.
  303. # a) Example
  304. #- BIGEVENTS_PATTERN=due
  305. # b) All
  306. #- BIGEVENTS_PATTERN=received|start|due|end
  307. # c) Disabled
  308. - BIGEVENTS_PATTERN=NONE
  309. #---------------------------------------------------------------
  310. # ==== EMAIL DUE DATE NOTIFICATION =====
  311. # https://github.com/wekan/wekan/pull/2536
  312. # System timelines will be showing any user modification for
  313. # dueat startat endat receivedat, also notification to
  314. # the watchers and if any card is due, about due or past due.
  315. #
  316. # Notify due days, default is None, 2 days before and on the event day
  317. #- NOTIFY_DUE_DAYS_BEFORE_AND_AFTER=2,0
  318. #
  319. # Notify due at hour of day. Default every morning at 8am. Can be 0-23.
  320. # If env variable has parsing error, use default. Notification sent to watchers.
  321. #- NOTIFY_DUE_AT_HOUR_OF_DAY=8
  322. #-----------------------------------------------------------------
  323. # ==== EMAIL NOTIFICATION TIMEOUT, ms =====
  324. # Default: 30000 ms = 30s
  325. #- EMAIL_NOTIFICATION_TIMEOUT=30000
  326. #-----------------------------------------------------------------
  327. # ==== CORS =====
  328. # CORS: Set Access-Control-Allow-Origin header.
  329. #- CORS=*
  330. # CORS_ALLOW_HEADERS: Set Access-Control-Allow-Headers header. "Authorization,Content-Type" is required for cross-origin use of the API.
  331. #- CORS_ALLOW_HEADERS=Authorization,Content-Type
  332. # CORS_EXPOSE_HEADERS: Set Access-Control-Expose-Headers header. This is not needed for typical CORS situations
  333. #- CORS_EXPOSE_HEADERS=*
  334. #-----------------------------------------------------------------
  335. # ==== MATOMO INTEGRATION ====
  336. # Optional: Integration with Matomo https://matomo.org that is installed to your server
  337. # The address of the server where Matomo is hosted.
  338. #- MATOMO_ADDRESS=https://example.com/matomo
  339. # The value of the site ID given in Matomo server for Wekan
  340. #- MATOMO_SITE_ID=1
  341. # The option do not track which enables users to not be tracked by matomo
  342. #- MATOMO_DO_NOT_TRACK=true
  343. # The option that allows matomo to retrieve the username:
  344. #- MATOMO_WITH_USERNAME=true
  345. #-----------------------------------------------------------------
  346. # ==== BROWSER POLICY AND TRUSTED IFRAME URL ====
  347. # Enable browser policy and allow one trusted URL that can have iframe that has Wekan embedded inside.
  348. # Setting this to false is not recommended, it also disables all other browser policy protections
  349. # and allows all iframing etc. See wekan/server/policy.js
  350. - BROWSER_POLICY_ENABLED=true
  351. # When browser policy is enabled, HTML code at this Trusted URL can have iframe that embeds Wekan inside.
  352. #- TRUSTED_URL=https://intra.example.com
  353. #-----------------------------------------------------------------
  354. # ==== METRICS ALLOWED IP ADDRESSES ====
  355. # https://github.com/wekan/wekan/wiki/Metrics
  356. #- METRICS_ALLOWED_IP_ADDRESSES=192.168.0.100,192.168.0.200
  357. #-----------------------------------------------------------------
  358. # ==== OUTGOING WEBHOOKS ====
  359. # What to send to Outgoing Webhook, or leave out. If commented out the default values will be: cardId,listId,oldListId,boardId,comment,user,card,commentId,swimlaneId,customerField,customFieldValue
  360. #- WEBHOOKS_ATTRIBUTES=cardId,listId,oldListId,boardId,comment,user,card,commentId
  361. #-----------------------------------------------------------------
  362. # ==== Debug OIDC OAuth2 etc ====
  363. #- DEBUG=true
  364. #---------------------------------------------
  365. # ==== AUTOLOGIN WITH OIDC/OAUTH2 ====
  366. # https://github.com/wekan/wekan/wiki/autologin
  367. #- OIDC_REDIRECTION_ENABLED=true
  368. #-----------------------------------------------------------------
  369. # ==== OAUTH2 ORACLE on premise identity manager OIM ====
  370. #- ORACLE_OIM_ENABLED=true
  371. #-----------------------------------------------------------------
  372. # ==== OAUTH2 AZURE ====
  373. # https://github.com/wekan/wekan/wiki/Azure
  374. # 1) Register the application with Azure. Make sure you capture
  375. # the application ID as well as generate a secret key.
  376. # 2) Configure the environment variables. This differs slightly
  377. # by installation type, but make sure you have the following:
  378. #- OAUTH2_ENABLED=true
  379. # Optional OAuth2 CA Cert, see https://github.com/wekan/wekan/issues/3299
  380. #- OAUTH2_CA_CERT=ABCD1234
  381. # Use OAuth2 ADFS additional changes. Also needs OAUTH2_ENABLED=true setting.
  382. #- OAUTH2_ADFS_ENABLED=false
  383. # OAuth2 login style: popup or redirect.
  384. #- OAUTH2_LOGIN_STYLE=redirect
  385. # Application GUID captured during app registration:
  386. #- OAUTH2_CLIENT_ID=xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx
  387. # Secret key generated during app registration:
  388. #- OAUTH2_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  389. #- OAUTH2_SERVER_URL=https://login.microsoftonline.com/
  390. #- OAUTH2_AUTH_ENDPOINT=/oauth2/v2.0/authorize
  391. #- OAUTH2_USERINFO_ENDPOINT=https://graph.microsoft.com/oidc/userinfo
  392. #- OAUTH2_TOKEN_ENDPOINT=/oauth2/v2.0/token
  393. # The claim name you want to map to the unique ID field:
  394. #- OAUTH2_ID_MAP=email
  395. # The claim name you want to map to the username field:
  396. #- OAUTH2_USERNAME_MAP=email
  397. # The claim name you want to map to the full name field:
  398. #- OAUTH2_FULLNAME_MAP=name
  399. # The claim name you want to map to the email field:
  400. #- OAUTH2_EMAIL_MAP=email
  401. #-----------------------------------------------------------------
  402. # ==== OAUTH2 Nextcloud ====
  403. # 1) Register the application with Nextcloud: https://your.nextcloud/index.php/settings/admin/security
  404. # Make sure you capture the application ID as well as generate a secret key.
  405. # Use https://your.wekan/_oauth/oidc for the redirect URI.
  406. # 2) Configure the environment variables. This differs slightly
  407. # by installation type, but make sure you have the following:
  408. #- OAUTH2_ENABLED=true
  409. # OAuth2 login style: popup or redirect.
  410. #- OAUTH2_LOGIN_STYLE=redirect
  411. # Application GUID captured during app registration:
  412. #- OAUTH2_CLIENT_ID=xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx
  413. # Secret key generated during app registration:
  414. #- OAUTH2_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  415. #- OAUTH2_SERVER_URL=https://your-nextcloud.tld
  416. #- OAUTH2_AUTH_ENDPOINT=/index.php/apps/oauth2/authorize
  417. #- OAUTH2_USERINFO_ENDPOINT=/ocs/v2.php/cloud/user?format=json
  418. #- OAUTH2_TOKEN_ENDPOINT=/index.php/apps/oauth2/api/v1/token
  419. # The claim name you want to map to the unique ID field:
  420. #- OAUTH2_ID_MAP=id
  421. # The claim name you want to map to the username field:
  422. #- OAUTH2_USERNAME_MAP=id
  423. # The claim name you want to map to the full name field:
  424. #- OAUTH2_FULLNAME_MAP=display-name
  425. # The claim name you want to map to the email field:
  426. #- OAUTH2_EMAIL_MAP=email
  427. #-----------------------------------------------------------------
  428. # ==== OAUTH2 KEYCLOAK ====
  429. # https://github.com/wekan/wekan/wiki/Keycloak <== MAPPING INFO, REQUIRED
  430. #- OAUTH2_ENABLED=true
  431. # OAuth2 login style: popup or redirect.
  432. #- OAUTH2_LOGIN_STYLE=redirect
  433. #- OAUTH2_CLIENT_ID=<Keycloak create Client ID>
  434. #- OAUTH2_SERVER_URL=<Keycloak server name>/auth
  435. #- OAUTH2_AUTH_ENDPOINT=/realms/<keycloak realm>/protocol/openid-connect/auth
  436. #- OAUTH2_USERINFO_ENDPOINT=/realms/<keycloak realm>/protocol/openid-connect/userinfo
  437. #- OAUTH2_TOKEN_ENDPOINT=/realms/<keycloak realm>/protocol/openid-connect/token
  438. #- OAUTH2_SECRET=<keycloak client secret>
  439. #-----------------------------------------------------------------
  440. # ==== OAUTH2 DOORKEEPER ====
  441. # https://github.com/wekan/wekan/issues/1874
  442. # https://github.com/wekan/wekan/wiki/OAuth2
  443. # Enable the OAuth2 connection
  444. #- OAUTH2_ENABLED=true
  445. # OAuth2 docs: https://github.com/wekan/wekan/wiki/OAuth2
  446. # OAuth2 login style: popup or redirect.
  447. #- OAUTH2_LOGIN_STYLE=redirect
  448. # OAuth2 Client ID.
  449. #- OAUTH2_CLIENT_ID=abcde12345
  450. # OAuth2 Secret.
  451. #- OAUTH2_SECRET=54321abcde
  452. # OAuth2 Server URL.
  453. #- OAUTH2_SERVER_URL=https://chat.example.com
  454. # OAuth2 Authorization Endpoint.
  455. #- OAUTH2_AUTH_ENDPOINT=/oauth/authorize
  456. # OAuth2 Userinfo Endpoint.
  457. #- OAUTH2_USERINFO_ENDPOINT=/oauth/userinfo
  458. # OAuth2 Token Endpoint.
  459. #- OAUTH2_TOKEN_ENDPOINT=/oauth/token
  460. # OAUTH2 ID Token Whitelist Fields.
  461. #- OAUTH2_ID_TOKEN_WHITELIST_FIELDS=""
  462. # OAUTH2 Request Permissions.
  463. #- OAUTH2_REQUEST_PERMISSIONS=openid profile email
  464. # OAuth2 ID Mapping
  465. #- OAUTH2_ID_MAP=
  466. # OAuth2 Username Mapping
  467. #- OAUTH2_USERNAME_MAP=
  468. # OAuth2 Fullname Mapping
  469. #- OAUTH2_FULLNAME_MAP=
  470. # OAuth2 Email Mapping
  471. #- OAUTH2_EMAIL_MAP=
  472. #-----------------------------------------------------------------
  473. # ==== LDAP: UNCOMMENT ALL TO ENABLE LDAP ====
  474. # https://github.com/wekan/wekan/wiki/LDAP
  475. # For Snap settings see https://github.com/wekan/wekan-snap/wiki/Supported-settings-keys
  476. # Most settings work both on Snap and Docker below.
  477. # Note: Do not add single quotes '' to variables. Having spaces still works without quotes where required.
  478. #
  479. # The default authentication method used if a user does not exist to create and authenticate. Can be set as ldap.
  480. # (this is set properly in the Admin Panel, changing this item does not remove Password login option)
  481. #- DEFAULT_AUTHENTICATION_METHOD=ldap
  482. #
  483. # Enable or not the connection by the LDAP
  484. #- LDAP_ENABLE=true
  485. #
  486. # The port of the LDAP server
  487. #- LDAP_PORT=389
  488. #
  489. # The host server for the LDAP server
  490. #- LDAP_HOST=localhost
  491. #
  492. #-----------------------------------------------------------------
  493. # ==== LDAP AD Simple Auth ====
  494. #
  495. # Set to true, if you want to connect with Active Directory by Simple Authentication.
  496. # When using AD Simple Auth, LDAP_BASEDN is not needed.
  497. #
  498. # Example:
  499. #- LDAP_AD_SIMPLE_AUTH=true
  500. #
  501. # === LDAP User Authentication ===
  502. #
  503. # a) Option to login to the LDAP server with the user's own username and password, instead of
  504. # an administrator key. Default: false (use administrator key).
  505. #
  506. # b) When using AD Simple Auth, set to true, when login user is used for binding,
  507. # and LDAP_BASEDN is not needed.
  508. #
  509. # Example:
  510. #- LDAP_USER_AUTHENTICATION=true
  511. #
  512. # Which field is used to find the user for the user authentication. Default: uid.
  513. #- LDAP_USER_AUTHENTICATION_FIELD=uid
  514. #
  515. # === LDAP Default Domain ===
  516. #
  517. # a) In case AD SimpleAuth is configured, the default domain is appended to the given
  518. # loginname for creating the correct username for the bind request to AD.
  519. #
  520. # b) The default domain of the ldap it is used to create email if the field is not map
  521. # correctly with the LDAP_SYNC_USER_DATA_FIELDMAP
  522. #
  523. # Example :
  524. #- LDAP_DEFAULT_DOMAIN=mydomain.com
  525. #
  526. #-----------------------------------------------------------------
  527. # ==== LDAP BASEDN Auth ====
  528. #
  529. # The base DN for the LDAP Tree
  530. #- LDAP_BASEDN=ou=user,dc=example,dc=org
  531. #
  532. #-----------------------------------------------------------------
  533. # Fallback on the default authentication method
  534. #- LDAP_LOGIN_FALLBACK=false
  535. #
  536. # Reconnect to the server if the connection is lost
  537. #- LDAP_RECONNECT=true
  538. #
  539. # Overall timeout, in milliseconds
  540. #- LDAP_TIMEOUT=10000
  541. #
  542. # Specifies the timeout for idle LDAP connections in milliseconds
  543. #- LDAP_IDLE_TIMEOUT=10000
  544. #
  545. # Connection timeout, in milliseconds
  546. #- LDAP_CONNECT_TIMEOUT=10000
  547. #
  548. # If the LDAP needs a user account to search
  549. #- LDAP_AUTHENTIFICATION=true
  550. #
  551. # The search user DN - You need quotes when you have spaces in parameters
  552. # 2 examples:
  553. #- LDAP_AUTHENTIFICATION_USERDN=CN=ldap admin,CN=users,DC=domainmatter,DC=lan
  554. #- LDAP_AUTHENTIFICATION_USERDN=CN=wekan_adm,OU=serviceaccounts,OU=admin,OU=prod,DC=mydomain,DC=com
  555. #
  556. # The password for the search user
  557. #- LDAP_AUTHENTIFICATION_PASSWORD=pwd
  558. #
  559. # Enable logs for the module
  560. #- LDAP_LOG_ENABLED=true
  561. #
  562. # If the sync of the users should be done in the background
  563. #- LDAP_BACKGROUND_SYNC=false
  564. #
  565. # At which interval does the background task sync.
  566. # The format must be as specified in:
  567. # https://bunkat.github.io/later/parsers.html#text
  568. #- LDAP_BACKGROUND_SYNC_INTERVAL=every 1 hour
  569. #
  570. #- LDAP_BACKGROUND_SYNC_KEEP_EXISTANT_USERS_UPDATED=false
  571. #
  572. #- LDAP_BACKGROUND_SYNC_IMPORT_NEW_USERS=false
  573. #
  574. # If using LDAPS: LDAP_ENCRYPTION=ssl
  575. #- LDAP_ENCRYPTION=false
  576. #
  577. # The certification for the LDAPS server. Certificate needs to be included in this docker-compose.yml file.
  578. #- LDAP_CA_CERT=-----BEGIN CERTIFICATE-----MIIE+G2FIdAgIC...-----END CERTIFICATE-----
  579. #
  580. # Reject Unauthorized Certificate
  581. #- LDAP_REJECT_UNAUTHORIZED=false
  582. #
  583. # Optional extra LDAP filters. Don't forget the outmost enclosing parentheses if needed
  584. #- LDAP_USER_SEARCH_FILTER=
  585. #
  586. # base (search only in the provided DN), one (search only in the provided DN and one level deep), or sub (search the whole subtree)
  587. #- LDAP_USER_SEARCH_SCOPE=one
  588. #
  589. # Which field is used to find the user, like uid / sAMAccountName
  590. #- LDAP_USER_SEARCH_FIELD=sAMAccountName
  591. #
  592. # Used for pagination (0=unlimited)
  593. #- LDAP_SEARCH_PAGE_SIZE=0
  594. #
  595. # The limit number of entries (0=unlimited)
  596. #- LDAP_SEARCH_SIZE_LIMIT=0
  597. #
  598. # Enable group filtering. Note the authenticated ldap user must be able to query all relevant group data with own login data from ldap.
  599. #- LDAP_GROUP_FILTER_ENABLE=false
  600. #
  601. # The object class for filtering. Example: group
  602. #- LDAP_GROUP_FILTER_OBJECTCLASS=
  603. #
  604. # The attribute of a group identifying it. Example: cn
  605. #- LDAP_GROUP_FILTER_GROUP_ID_ATTRIBUTE=
  606. #
  607. # The attribute inside a group object listing its members. Example: member
  608. #- LDAP_GROUP_FILTER_GROUP_MEMBER_ATTRIBUTE=
  609. #
  610. # The format of the value of LDAP_GROUP_FILTER_GROUP_MEMBER_ATTRIBUTE. Example: 'dn' if the users dn is saved as value into the attribute.
  611. #- LDAP_GROUP_FILTER_GROUP_MEMBER_FORMAT=
  612. #
  613. # The group name (id) that matches all users.
  614. #- LDAP_GROUP_FILTER_GROUP_NAME=
  615. #
  616. # LDAP_UNIQUE_IDENTIFIER_FIELD : This field is sometimes class GUID (Globally Unique Identifier). Example: guid
  617. #- LDAP_UNIQUE_IDENTIFIER_FIELD=
  618. #
  619. # LDAP_UTF8_NAMES_SLUGIFY : Convert the username to utf8
  620. #- LDAP_UTF8_NAMES_SLUGIFY=true
  621. #
  622. # LDAP_USERNAME_FIELD : Which field contains the ldap username. username / sAMAccountName
  623. #- LDAP_USERNAME_FIELD=sAMAccountName
  624. #
  625. # LDAP_FULLNAME_FIELD : Which field contains the ldap fullname. fullname / sAMAccountName
  626. #- LDAP_FULLNAME_FIELD=fullname
  627. #
  628. #- LDAP_MERGE_EXISTING_USERS=false
  629. #
  630. # Allow existing account matching by e-mail address when username does not match
  631. #- LDAP_EMAIL_MATCH_ENABLE=true
  632. #
  633. # LDAP_EMAIL_MATCH_REQUIRE : require existing account matching by e-mail address when username does match
  634. #- LDAP_EMAIL_MATCH_REQUIRE=true
  635. #
  636. # LDAP_EMAIL_MATCH_VERIFIED : require existing account email address to be verified for matching
  637. #- LDAP_EMAIL_MATCH_VERIFIED=true
  638. #
  639. # LDAP_EMAIL_FIELD : which field contains the LDAP e-mail address
  640. #- LDAP_EMAIL_FIELD=mail
  641. #-----------------------------------------------------------------
  642. #- LDAP_SYNC_USER_DATA=false
  643. #
  644. #- LDAP_SYNC_USER_DATA_FIELDMAP={"cn":"name", "mail":"email"}
  645. #
  646. #- LDAP_SYNC_GROUP_ROLES=
  647. #
  648. # The default domain of the ldap it is used to create email if the field is not map correctly
  649. # with the LDAP_SYNC_USER_DATA_FIELDMAP is defined in setting LDAP_DEFAULT_DOMAIN above.
  650. #
  651. # Enable/Disable syncing of admin status based on ldap groups:
  652. #- LDAP_SYNC_ADMIN_STATUS=true
  653. #
  654. # Comma separated list of admin group names to sync.
  655. #- LDAP_SYNC_ADMIN_GROUPS=group1,group2
  656. #---------------------------------------------------------------------
  657. # Login to LDAP automatically with HTTP header.
  658. # In below example for siteminder, at right side of = is header name.
  659. #- HEADER_LOGIN_ID=HEADERUID
  660. #- HEADER_LOGIN_FIRSTNAME=HEADERFIRSTNAME
  661. #- HEADER_LOGIN_LASTNAME=HEADERLASTNAME
  662. #- HEADER_LOGIN_EMAIL=HEADEREMAILADDRESS
  663. #---------------------------------------------------------------------
  664. # ==== LOGOUT TIMER, probably does not work yet ====
  665. # LOGOUT_WITH_TIMER : Enables or not the option logout with timer
  666. # example : LOGOUT_WITH_TIMER=true
  667. #- LOGOUT_WITH_TIMER=
  668. #
  669. # LOGOUT_IN : The number of days
  670. # example : LOGOUT_IN=1
  671. #- LOGOUT_IN=
  672. #
  673. # LOGOUT_ON_HOURS : The number of hours
  674. # example : LOGOUT_ON_HOURS=9
  675. #- LOGOUT_ON_HOURS=
  676. #
  677. # LOGOUT_ON_MINUTES : The number of minutes
  678. # example : LOGOUT_ON_MINUTES=55
  679. #- LOGOUT_ON_MINUTES=
  680. #-------------------------------------------------------------------
  681. # Hide password login form
  682. # - PASSWORD_LOGIN_ENABLED=true
  683. #-------------------------------------------------------------------
  684. #- CAS_ENABLED=true
  685. #- CAS_BASE_URL=https://cas.example.com/cas
  686. #- CAS_LOGIN_URL=https://cas.example.com/login
  687. #- CAS_VALIDATE_URL=https://cas.example.com/cas/p3/serviceValidate
  688. #---------------------------------------------------------------------
  689. #- SAML_ENABLED=true
  690. #- SAML_PROVIDER=
  691. #- SAML_ENTRYPOINT=
  692. #- SAML_ISSUER=
  693. #- SAML_CERT=
  694. #- SAML_IDPSLO_REDIRECTURL=
  695. #- SAML_PRIVATE_KEYFILE=
  696. #- SAML_PUBLIC_CERTFILE=
  697. #- SAML_IDENTIFIER_FORMAT=
  698. #- SAML_LOCAL_PROFILE_MATCH_ATTRIBUTE=
  699. #- SAML_ATTRIBUTES=
  700. #---------------------------------------------------------------------
  701. # Wait spinner to use
  702. # - WAIT_SPINNER=Bounce
  703. #---------------------------------------------------------------------
  704. depends_on:
  705. - wekandb
  706. volumes:
  707. - /etc/localtime:/etc/localtime:ro
  708. - wekan-files:/data:rw
  709. #---------------------------------------------------------------------------------
  710. # ==== OPTIONAL: SHARE DATABASE TO OFFICE LAN AND REMOTE VPN ====
  711. # When using Wekan both at office LAN and remote VPN:
  712. # 1) Have above Wekan docker container config with LAN IP address
  713. # 2) Copy all of above wekan container config below, look above of this part above and all config below it,
  714. # before above depends_on: part:
  715. #
  716. # wekan:
  717. # #-------------------------------------------------------------------------------------
  718. # # ==== MONGODB AND METEOR VERSION ====
  719. # # a) For Wekan Meteor 1.8.x version at meteor-1.8 branch, .....
  720. #
  721. #
  722. # and change name to different name like wekan2 or wekanvpn, and change ROOT_URL to server VPN IP
  723. # address.
  724. # 3) This way both Wekan containers can use same MongoDB database
  725. # and see the same Wekan boards.
  726. # 4) You could also add 3rd Wekan container for 3rd network etc.
  727. # EXAMPLE:
  728. # wekan2:
  729. # ....COPY CONFIG FROM ABOVE TO HERE...
  730. # environment:
  731. # - ROOT_URL='http://10.10.10.10'
  732. # ...COPY CONFIG FROM ABOVE TO HERE...
  733. #---------------------------------------------------------------------------------
  734. # OPTIONAL NGINX CONFIG FOR REVERSE PROXY
  735. # nginx:
  736. # image: nginx
  737. # container_name: nginx
  738. # restart: always
  739. # networks:
  740. # - wekan-tier
  741. # depends_on:
  742. # - wekan
  743. # ports:
  744. # - 80:80
  745. # - 443:443
  746. # volumes:
  747. # - ./nginx/ssl:/etc/nginx/ssl/:ro
  748. # - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
  749. ## Alternative volume config:
  750. ## volumes:
  751. ## - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro
  752. ## - ./nginx/ssl/ssl.conf:/etc/nginx/conf.d/ssl/ssl.conf:ro
  753. ## - ./nginx/ssl/testvm-ehu.crt:/etc/nginx/conf.d/ssl/certs/mycert.crt:ro
  754. ## - ./nginx/ssl/testvm-ehu.key:/etc/nginx/conf.d/ssl/certs/mykey.key:ro
  755. ## - ./nginx/ssl/pphrase:/etc/nginx/conf.d/ssl/pphrase:ro
  756. volumes:
  757. wekan-files:
  758. driver: local
  759. wekan-db:
  760. driver: local
  761. wekan-db-dump:
  762. driver: local
  763. networks:
  764. wekan-tier:
  765. driver: bridge