docker-compose.yml 34 KB

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