@carlsonp/kort v1.0.1
Kort
Table of Contents
About
Screenshots
Installation and Setup
After Install
Support / Improvement / Suggestions
License
About
A web application supporting multiple user experience (UX) research methods.
See the website for more information.
Screenshots
Installation and Setup
Use one of the following:
- Use Git to clone the code (
git clone https://github.com/carlsonp/kort.git
) - Download a release archive from Github
- Install from the published npm package via
npm install @carlsonp/kort
- Use Git to clone the code (
Edit
app.js
and optionally set theadminUser
and set your own username.Edit the
adminPassword
value inapp.js
.Optionally set
allowUserRegistration
inapp.js
to allow users to register. Otherwise users can only be created by accounts with 'admin' access.Optionally setup Google authentication. See the wiki for details.
Continue installation via source or via Docker.
Via Source
Install Node.js
Install MongoDB (3.0 or higher) or provide a connection to an existing server by editing the
app.js
file and setting themongoURL
. Kort uses the Mongoose package To optionally secure your MongoDB with a username and password, create a user for thekort
database by doing the following:Open a Mongo commandline shell: ```bash mongo --port 27017 ``` Select the database: ```mongo use kort ``` Create the new user: ```mongo db.createUser( { user: "kort", pwd: "123", roles: [ { role: "readWrite", db: "kort" } ] } ) ``` Then edit `/etc/mongodb.conf` and enable `auth=true`. Restart the service. Make sure to set the `mongoURL` with the appropriate username and password.
Run
npm install
on the commandline. This will install the dependencies into thenode_modules
folder.Run
node app.js
from the main directory. This will start the NodeJS server on the default port 3000.
Via Docker
Build the containers
docker-compose build
Start the containers (use -d to run in detached mode)
docker-compose up
Stop the containers (when using detached mode)
docker-compose down
Data from MongoDB is persisted and mounted as a Docker volume in the ./data/
folder.
After Install
You can connect via http://localhost:3000
The
adminUser
andadminPassword
that is set inapp.js
is the username and password for the account that will be created upon first launch. Use this to login.
Support / Improvement / Suggestions
Open a Github issue.
License
Kort is licensed under the GPLv3.