mirror of
https://github.com/wekan/wekan.git
synced 2025-04-23 21:47:10 -04:00
Add changes from wiki to docs.
Thanks to xet7 !
This commit is contained in:
Lauri Ojansivu
parent
b86a24d97a
commit
13be8160d5
10 changed files with 177 additions and 33 deletions
3
docs/wekan.wiki/AsyncAwait.md
Normal file
3
docs/wekan.wiki/AsyncAwait.md
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
- https://www.sitepoint.com/javascript-async-await/
|
||||
- https://www.freecodecamp.org/news/javascript-async-await-tutorial-learn-callbacks-promises-async-await-by-making-icecream/
|
||||
- https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Asynchronous
|
||||
|
|
@ -4,10 +4,12 @@
|
|||
|
||||
*Make sure you are running at least **v2.21***
|
||||
|
||||
### Snap install info, tested 2021-07-16
|
||||
### Redirect URL
|
||||
|
||||
[About AZURE-NEW-APP-CLIENT-ID and AZURE-NEW-APP-SECRET](https://community.microfocus.com/t5/Identity-Manager-Tips/Creating-the-application-Client-ID-and-Client-Secret-from/ta-p/1776619). The redirect URL is your Wekan root-url+_oauth/oidc like this: https://boards.example.com/_oauth/oidc
|
||||
|
||||
<img src="https://wekan.github.io/azure-redirect.png" width="100%" alt="Wekan logo" />
|
||||
|
||||
AZURE_DIRECTORY_ID = TENANT-NAME-FOR-YOUR-ORGANIZATION
|
||||
|
||||
### If Azure Active Directory login does not work
|
||||
|
|
|
|||
|
|
@ -35,6 +35,13 @@ docker exec wekan-db mongorestore --drop --dir=/data/dump
|
|||
docker start wekan-app
|
||||
```
|
||||
# Upgrade Docker Wekan version
|
||||
|
||||
## Newest info
|
||||
|
||||
https://github.com/wekan/wekan/discussions/5367
|
||||
|
||||
## Old info
|
||||
|
||||
Note: Do not run `docker-compose down` without verifying your docker-compose file, it does not delete the data by default but caution is advised. Refer to https://docs.docker.com/compose/reference/down/.
|
||||
```bash
|
||||
docker-compose stop
|
||||
|
|
|
|||
32
docs/wekan.wiki/Change-Language.md
Normal file
32
docs/wekan.wiki/Change-Language.md
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
## Change language for all users
|
||||
|
||||
Using MongoDB Shell with WeKan Snap Candidate, to change English date format to `DD/MM/YY`.
|
||||
|
||||
MongoDB Shell Download: https://www.mongodb.com/try/download/shell
|
||||
|
||||
language.sh:
|
||||
```
|
||||
mongosh --quiet \
|
||||
--host 127.0.0.1 \
|
||||
--port 27019 \
|
||||
--eval 'use wekan' \
|
||||
--eval 'db.users.updateMany({}, { $set: {"profile.language": "en-GB" }});'
|
||||
```
|
||||
Set script as executeable:
|
||||
```
|
||||
chmod +x language.sh
|
||||
```
|
||||
Running script, when 5 new users of total 20 users did not have language set correctly yet:
|
||||
```
|
||||
$ ./language.sh
|
||||
{
|
||||
acknowledged: true,
|
||||
insertedId: null,
|
||||
matchedCount: 20,
|
||||
modifiedCount: 5,
|
||||
upsertedCount: 0
|
||||
}
|
||||
```
|
||||
## Language browser settings
|
||||
|
||||
https://github.com/wekan/wekan/issues/4518#issuecomment-1133763518
|
||||
|
|
@ -60,6 +60,34 @@ It's a very specific niche, with limited amount competitors, with all of this ap
|
|||
|
||||
[Wekan Team](https://wekan.team) is Wekan Commercial Support company run by CEO [xet7](https://github.com/xet7), current maintainer of Wekan. xet7 does respond to feedback at GitHub issues very actively, because Wekan is community driven Open Source project. Because conflicting opinions can not be implemented, sometimes xet7 has to behave like a benevolent dictator. Every Wekan team member is free to choose what to contribute and when. We can not force anybody to implement anything. Wekan development speed increases when new Wekan contributors join and start to send PRs to existing and new issues.
|
||||
|
||||
## What is Bio of xet7 ?
|
||||
|
||||
[Lauri Ojansivu](https://github.com/xet7) is CEO at [WeKan Team](https://wekan.team),
|
||||
Cross-Platform FOSS maintainer,
|
||||
Cloud Architect, Full-Stack Developer, SysAdmin and SysOp.
|
||||
He has experience of [having added and removed over 4 million lines of code](https://github.com/wekan/wekan/blob/main/releases/count-lines-of-code-per-committer.sh) to
|
||||
[Meteor Full-Stack Web Framework](https://www.meteor.com)
|
||||
based [WeKan Open Source kanban](https://wekan.github.io),
|
||||
that has been [translated to 70+ languages](https://explore.transifex.com/wekan/wekan/),
|
||||
and is currently used at [most countries of the world](https://snapcraft.io/wekan).
|
||||
At 2024-06-04, he is currently [4h most active GitHub committer at Finland](https://committers.top/finland).
|
||||
|
||||
He holds a BBA as computer designer and system engineer
|
||||
at Kemi-Tornio AMK, Finland.
|
||||
He is credited as having built quality control system
|
||||
with comparisons of groups and fitness test calculations,
|
||||
company infra, migration from On-Premises to Cloud,
|
||||
SLA support, IT support, games, database apps, websites,
|
||||
[winner of 2th place at EU NGI ONTOCHAIN Hackathon](https://wekan.github.io/donated/ontochain-certificate.png),
|
||||
[winner of 20i FOSS Awards](https://wekan.github.io/donated/foss-awards-2022/20i_FOSS_Awards_Winners_Announced_(Press_Release).pdf), and [porting to 30+ CPU/OS](https://github.com/xet7/darkesthour).
|
||||
|
||||
At MeteorJS Dispatches Video Podcast, he has been
|
||||
interviewed [about WeKan](https://www.youtube.com/watch?v=ke-mbnZM3zE&t=1342s),
|
||||
[Meteor Security](https://www.youtube.com/watch?v=zic-h8jG6F8), and other topics.
|
||||
He teaches using computers at local nerd club.
|
||||
At his free time, he is porting FOSS software to many CPU/OS,
|
||||
and [translating them from English to Finnish](https://xet7.org).
|
||||
|
||||
## How to convince my company management that Wekan "is less evil" than Trello?
|
||||
|
||||
Yes, xet7 received this question in Email.
|
||||
|
|
|
|||
|
|
@ -1,14 +1,17 @@
|
|||
# Newest Windows info here
|
||||
|
||||
https://github.com/wekan/wekan/wiki/Offline
|
||||
|
||||
## OLD INFO BELOW, DOES NOT WORK
|
||||
|
||||
Also see: [Excel and VBA](Excel-and-VBA)
|
||||
|
||||
|
||||
# THIS WORKS
|
||||
a) Lowest resource usage: [Windows Subsystem for Linux, build from source](https://github.com/wekan/wekan/issues/2066#issuecomment-468328001)
|
||||
|
||||
b) Docker for Windows, [prebuilt without --build option, or build from source](https://github.com/wekan/wekan-dev/issues/12#issuecomment-468657290)
|
||||
|
||||
***
|
||||
|
||||
# OLD INFO BELOW, DOES NOT WORK
|
||||
|
||||
### Source install required dependencies
|
||||
|
||||
|
|
|
|||
|
|
@ -1,3 +1,4 @@
|
|||
- [More RocketChat fixes here](https://github.com/wekan/wekan/wiki/RocketChat)
|
||||
- [OAuth2 small bug](https://github.com/wekan/wekan/issues/1874) - currently OAuth2 works mostly
|
||||
|
||||
# OAuth2 providers
|
||||
|
|
@ -41,6 +42,7 @@ The redirect URL is described in the wekan wiki: https://wekan.example.com/_oaut
|
|||
|
||||
## Rocket.Chat providing OAuth2 login to Wekan
|
||||
|
||||
- [More RocketChat fixes here](https://github.com/wekan/wekan/wiki/RocketChat)
|
||||
- [RocketChat Skip Install Registration Wizard Fix](https://github.com/RocketChat/Rocket.Chat/issues/31163#issuecomment-1848364117)
|
||||
|
||||
> So for someone using snap, it means creating a file `/var/snap/rocketchat-server/common/override-setup-wizard.env ` (the name of the file itself could be anything as long as it has an .env extension) and setting its content to `OVERWRITE_SETTING_Show_Setup_Wizard=completed`
|
||||
|
|
|
|||
|
|
@ -2,50 +2,30 @@ Also see: [Windows](Windows)
|
|||
|
||||
[Other CPU/OS On-Premise WeKan install](https://github.com/wekan/wekan/wiki/Raspberry-Pi)
|
||||
|
||||
## Newest Docker WeKan Offline
|
||||
|
||||
This works now.
|
||||
|
||||
At Internet connected computer, download:
|
||||
|
||||
1. Docker for Windows
|
||||
2. docker-compose.yml from https://github.com/wekan/wekan
|
||||
3. `docker-compose up -d` at Internet connected computer
|
||||
4. Save wekan-app and wekan-db containers to files https://docs.docker.com/engine/reference/commandline/save/
|
||||
|
||||
At Offline Windows computer:
|
||||
|
||||
1. Install Docker for Windows
|
||||
2. Load `wekan-app` container from file https://docs.docker.com/engine/reference/commandline/load/
|
||||
3. Check what is ID of `wekan-app` container with `docker images`
|
||||
4. Change at `docker-compose.yml` wekan-app contaier `image:gc....` to `image:ID` where ID from step 3 above
|
||||
5. Do steps 2-4 also for `wekan-db` container
|
||||
6. `docker-compose up -d`
|
||||
|
||||
## Wekan Windows 64bit version On-Premise
|
||||
|
||||
This does not work yet.
|
||||
This is without container (without Docker or Snap).
|
||||
|
||||
Right click and download files 1-4:
|
||||
|
||||
1. [wekan-7.18-amd64-windows.zip](https://github.com/wekan/wekan/releases/download/v7.18/wekan-7.18-amd64-windows.zip)
|
||||
1. [wekan-7.47-amd64-windows.zip](https://github.com/wekan/wekan/releases/download/v7.47/wekan-7.47-amd64-windows.zip)
|
||||
|
||||
2. [node-v14.21.4-win-x64.exe](https://github.com/wekan/node-v14-esm/releases/download/v14.21.4/node-v14.21.4-win-x64.exe)
|
||||
2. [node.exe](https://nodejs.org/dist/latest-v14.x/win-x64/node.exe)
|
||||
|
||||
3. [mongodb-windows-x86_64-6.0.11-signed.msi](https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-6.0.11-signed.msi)
|
||||
3. [mongodb-windows-x86_64-6.0.15-signed.msi](https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-6.0.15-signed.msi)
|
||||
|
||||
4. [start-wekan.bat](https://raw.githubusercontent.com/wekan/wekan/main/start-wekan.bat)
|
||||
|
||||
5. Copy files from steps 1-4 with USB stick or DVD to offline Windows computer
|
||||
|
||||
6. Double click `mongodb-windows-x86_64-6.0.11-signed.msi` . In installer, uncheck downloading MongoDB compass.
|
||||
6. Double click `mongodb-windows-x86_64-6.0.15-signed.msi` . In installer, uncheck downloading MongoDB compass.
|
||||
|
||||
7. Unzip `wekan-7.18-amd64-windows.zip` , inside it is directory `bundle`, to it copy other files:
|
||||
7. Unzip `wekan-7.47-amd64-windows.zip` , inside it is directory `bundle`, to it copy other files:
|
||||
|
||||
```
|
||||
bundle (directory)
|
||||
|_ start-wekan.bat (downloaded file)
|
||||
|_ node-v14.21.4-win-x64.exe (downloaded file)
|
||||
|_ node.exe (downloaded file)
|
||||
|_ main.js (extracted file)
|
||||
```
|
||||
8. Edit `start-wekan.bat` with Notepad. There add [Windows computer IP address](https://support.microsoft.com/en-us/windows/find-your-ip-address-in-windows-f21a9bbc-c582-55cd-35e0-73431160a1b9) , like this, then Wekan will be at http://IP-ADDRESS-HERE/sign-in , for example http://192.168.0.100/sign-in but your different IP address. Add there wekan server computer IP address, not localhost. `node.exe main.js` is at bottom of `start-wekan.bat`, change there longer filename:
|
||||
|
|
@ -54,7 +34,7 @@ SET ROOT_URL=http://IP-ADDRESS-HERE
|
|||
|
||||
SET PORT=80
|
||||
|
||||
node-v14.21.4-win-x64.exe main.js
|
||||
node.exe main.js
|
||||
```
|
||||
If there is already some webserver at port 80, change to other port:
|
||||
```
|
||||
|
|
@ -75,6 +55,25 @@ RELATED INFO:
|
|||
- Windows 2022 server example https://github.com/wekan/wekan/issues/5084
|
||||
- Other settings example https://github.com/wekan/wekan/issues/4932
|
||||
|
||||
## Docker WeKan Offline
|
||||
|
||||
|
||||
At Internet connected computer, download:
|
||||
|
||||
1. Docker for Windows
|
||||
2. docker-compose.yml from https://github.com/wekan/wekan
|
||||
3. `docker-compose up -d` at Internet connected computer
|
||||
4. Save wekan-app and wekan-db containers to files https://docs.docker.com/engine/reference/commandline/save/
|
||||
|
||||
At Offline Windows computer:
|
||||
|
||||
1. Install Docker for Windows
|
||||
2. Load `wekan-app` container from file https://docs.docker.com/engine/reference/commandline/load/
|
||||
3. Check what is ID of `wekan-app` container with `docker images`
|
||||
4. Change at `docker-compose.yml` wekan-app contaier `image:gc....` to `image:ID` where ID from step 3 above
|
||||
5. Do steps 2-4 also for `wekan-db` container
|
||||
6. `docker-compose up -d`
|
||||
|
||||
## WeKan Updates
|
||||
|
||||
1. Updating only WeKan. Not updating Node.js and MongoDB.
|
||||
|
|
|
|||
68
docs/wekan.wiki/RocketChat.md
Normal file
68
docs/wekan.wiki/RocketChat.md
Normal file
|
|
@ -0,0 +1,68 @@
|
|||
Info for Self-Hosted RocketChat Community Server, using RocketChat server Snap from https://snapcraft.io/rocketchat-server
|
||||
|
||||
## Install snapd
|
||||
|
||||
Linux:
|
||||
|
||||
https://snapcraft.io/docs/installing-snapd
|
||||
|
||||
Windows:
|
||||
|
||||
https://github.com/wekan/hx/tree/main/prototypes/ui/gambas#install-on-windows
|
||||
|
||||
## Install RocketChat Snap
|
||||
|
||||
```
|
||||
sudo snap install rocketchat-server
|
||||
```
|
||||
|
||||
## Setup siteurl
|
||||
|
||||
List current Snap settings:
|
||||
```
|
||||
sudo snap get rocketchat-server
|
||||
```
|
||||
Then set your siteurl of your RocketChat server:
|
||||
```
|
||||
sudo snap set rocketchat-server siteurl='https://chat.yourcompany.com'
|
||||
```
|
||||
|
||||
## RocketChat Skip Install Registration Wizard Fix
|
||||
|
||||
Q:
|
||||
|
||||
- [RocketChat Skip Install Registration Wizard Fix](https://github.com/RocketChat/Rocket.Chat/issues/31163#issuecomment-1848364117)
|
||||
|
||||
|
||||
A:
|
||||
|
||||
For someone using snap, it means creating a file `/var/snap/rocketchat-server/common/override-setup-wizard.env ` (the name of the file itself could be anything as long as it has an .env extension) and setting its content to `OVERWRITE_SETTING_Show_Setup_Wizard=completed`
|
||||
|
||||
Then, restarting the server by `systemctl restart snap.rocketchat-server.rocketchat-server.service`
|
||||
|
||||
If it does not work yet, then reboot.
|
||||
|
||||
## Workspace version unsupported
|
||||
|
||||
Q:
|
||||
|
||||
- [Workspace version unsupported, Self-Host Community Server](https://forums.rocket.chat/t/workspace-version-unsupported-self-host-community-server/19698)
|
||||
|
||||
A:
|
||||
|
||||
1) Change to newest Snap Stable channel, list at https://snapcraft.io/rocketchat-server dropdown menu
|
||||
|
||||
```
|
||||
sudo snap refresh rocketchat-server --channel=6.x/stable --amend
|
||||
```
|
||||
|
||||
2) Register your Self-Managed instance here, so login and mobile app start to work after that:
|
||||
|
||||
- https://cloud.rocket.chat/home
|
||||
- https://chat.yourcompany.com/admin/subscription
|
||||
|
||||
## More RocketChat Snap related info
|
||||
|
||||
https://github.com/wekan/wekan/wiki/OAuth2
|
||||
|
||||
https://docs.rocket.chat/deploy/deploy-rocket.chat/deploy-with-snaps
|
||||
|
|
@ -6,7 +6,7 @@
|
|||
* [Meteor WeKan Roadmap](https://boards.wekan.team/b/D2SzJKZDS4Z48yeQH/wekan-open-source-kanban-board-with-mit-license) - board at Wekan demo
|
||||
* [Multiverse WeKan Roadmap](https://github.com/wekan/wekan/wiki/WeKan-Multiverse-Roadmap)
|
||||
* [Docs/Manual](https://github.com/wekan/wekan/discussions/4522)
|
||||
* [Change Language](https://github.com/wekan/wekan/issues/4518#issuecomment-1133763518)
|
||||
* [Change Language](Change-Language)
|
||||
* [Forgot Password](Forgot-Password)
|
||||
* [About](https://github.com/wekan/wekan/wiki)
|
||||
* [Test Edge](Test-Edge)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue