mirror of
https://github.com/wekan/wekan.git
synced 2025-12-16 23:40:13 +01:00
Updated Install Wekan from source on Windows (markdown)
parent
5c7af9604c
commit
7694b55e82
1 changed files with 90 additions and 2 deletions
|
|
@ -1,4 +1,12 @@
|
||||||
# Setup required dependencies
|
# Alternative: Docker, without build from source
|
||||||
|
|
||||||
|
Use Docker Compose:
|
||||||
|
https://github.com/wekan/wekan-mongodb
|
||||||
|
|
||||||
|
Or adding also MongoDB mirroring to PostgreSQL:
|
||||||
|
https://github.com/wekan/wekan-postgresql
|
||||||
|
|
||||||
|
# Source install required dependencies
|
||||||
|
|
||||||
Requirements:
|
Requirements:
|
||||||
- Install [MeteorJS](https://www.meteor.com/)
|
- Install [MeteorJS](https://www.meteor.com/)
|
||||||
|
|
@ -26,6 +34,16 @@ meteor npm config -g set msvs_version 2015
|
||||||
- open your browser, make changes and see it reflecting real-time.
|
- open your browser, make changes and see it reflecting real-time.
|
||||||
|
|
||||||
## Example of setting environment variables
|
## Example of setting environment variables
|
||||||
|
|
||||||
|
You need to have start-wekan.bat textfile with that content of those environment variables.
|
||||||
|
In Windows, .bat files use DOS style of setting varibles.
|
||||||
|
|
||||||
|
Similar file for Linux bash is here:
|
||||||
|
https://github.com/wekan/wekan-maintainer/blob/master/virtualbox/start-wekan.sh
|
||||||
|
|
||||||
|
ROOT_URL examples are here:
|
||||||
|
https://github.com/wekan/wekan/releases
|
||||||
|
|
||||||
```
|
```
|
||||||
SET MONGO_URL=mongodb://127.0.0.1:27017/wekan
|
SET MONGO_URL=mongodb://127.0.0.1:27017/wekan
|
||||||
SET ROOT_URL=http://127.0.0.1/
|
SET ROOT_URL=http://127.0.0.1/
|
||||||
|
|
@ -43,6 +61,11 @@ MAIL_FROM=admin@example.com
|
||||||
PORT=8081
|
PORT=8081
|
||||||
```
|
```
|
||||||
|
|
||||||
|
That URL format is: mongodb://ip-address-of-server:port/database-name
|
||||||
|
|
||||||
|
You can access MongoDB database with GUI like Robo 3T https://robomongo.org .
|
||||||
|
There is no username and password set by default.
|
||||||
|
|
||||||
## Overview,
|
## Overview,
|
||||||
Here is how it looks like,
|
Here is how it looks like,
|
||||||
```
|
```
|
||||||
|
|
@ -60,4 +83,69 @@ meteor
|
||||||
Make sure to install all required programs stated here, https://github.com/wekan/wekan/wiki/Install-Wekan-from-source-on-Windows#setup-required-dependencies
|
Make sure to install all required programs stated here, https://github.com/wekan/wekan/wiki/Install-Wekan-from-source-on-Windows#setup-required-dependencies
|
||||||
|
|
||||||
### I am getting `Error: Cannot find module 'fibers'` related problem.
|
### I am getting `Error: Cannot find module 'fibers'` related problem.
|
||||||
Make sure to run the command `meteor` instead of `node`.
|
Make sure to run the command `meteor` instead of `node`.
|
||||||
|
|
||||||
|
# VBA
|
||||||
|
|
||||||
|
For accessing Wekan with Excel VBA, you can use Wekan REST API:
|
||||||
|
https://github.com/wekan/wekan/wiki/REST-API
|
||||||
|
|
||||||
|
For example, with using curl, you first login with admin credentials,
|
||||||
|
by sending username and password to url.
|
||||||
|
Change your server url etc details to below:
|
||||||
|
|
||||||
|
```
|
||||||
|
curl http://localhost:3000/users/login \
|
||||||
|
-d "username=USER&password=PASSWORD"
|
||||||
|
```
|
||||||
|
=>
|
||||||
|
```
|
||||||
|
{
|
||||||
|
"id": "ABCDEFG123456",
|
||||||
|
"token": "AUTH-TOKEN",
|
||||||
|
"tokenExpires": "2018-07-15T14:23:18.313Z"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
Then you update card content by sending to card URL the new content:
|
||||||
|
|
||||||
|
curl -H "Authorization: Bearer AUTH-TOKEN" \
|
||||||
|
-H "Content-type:application/json" \
|
||||||
|
-X PUT \
|
||||||
|
http://localhost:3000/api/boards/ABCDEFG123456/lists/ABCDEFG123456/cards/ABCDEFG123456 \
|
||||||
|
-d '{ "title": "Card new title", "listId": "ABCDEFG123456", "description": "Card new description" }'
|
||||||
|
|
||||||
|
When using VBA, you can optionally:
|
||||||
|
|
||||||
|
a) Use direct VBA commands to send and receive from URLs
|
||||||
|
|
||||||
|
b) Download curl for Windows, and in VBA call curl.exe with those parameters, and get the result.
|
||||||
|
|
||||||
|
You can also google search how you can use JSON format files in VBA,
|
||||||
|
converting them to other formats etc. I presume there is something similar that
|
||||||
|
exists in PHP, that JSON file can be converted to PHP array, and array items accessed
|
||||||
|
individually, and array converted back to JSON.
|
||||||
|
|
||||||
|
Current Wekan REST API does not yet cover access to all data that is in MongoDB.
|
||||||
|
If you need that, REST API page also has link to Restheart, that adds REST API
|
||||||
|
to MongoDB, so youc an use all of MongoDB data directly with REST API.
|
||||||
|
https://github.com/wekan/wekan/wiki/REST-API
|
||||||
|
|
||||||
|
Wekan boards also have export JSON, where also attachments are included in JSON as
|
||||||
|
base64 encoded files. To convert them back to files, you first get whole one board exported
|
||||||
|
after authentication like this:
|
||||||
|
|
||||||
|
curl https://Bearer:APIKEY@ip-address/api/boards/BOARD-ID/export?authToken=#APIKEY > wekanboard.json
|
||||||
|
|
||||||
|
Then you read that JSON file with VBA, and get that part where in JSON is the base64 text
|
||||||
|
of the file. Then you use VBA base64 function to convert it to binary, and write content to file.
|
||||||
|
|
||||||
|
# CSV/TSC Import/Export
|
||||||
|
|
||||||
|
There is [CSV/TSV pull request](https://github.com/wekan/wekan/pull/413), but it has been made
|
||||||
|
a long time ago, it would need some work to add all the new tables, columns etc from
|
||||||
|
MongoDB database, so that it would export everything correctly.
|
||||||
|
|
||||||
|
Options are:
|
||||||
|
a) Some developer could do that work and contribute that code to Wekan as
|
||||||
|
new pull request to Wekan devel branch.
|
||||||
|
b) Use [Commercial Support](https://wekan.team) and pay for the time to get it implemented.
|
||||||
Loading…
Add table
Add a link
Reference in a new issue