weseek__growi/README.md

Demo Site

crowi-plus

crowi-plus is a fork of Crowi that is perfectly compatible with the official project.

Why crowi-plus?

• Pluggable
  • Find plugins from npm or github!
• Faster
  • Optimize client-side code chunks by Webpack
  • Adopt date-fns and omit Moment.js
  • Adopt the fastest logger pino
  • Using CDN
• Secure
  • Prevent XSS (Cross Site Scripting)
  • Upgrade jQuery to 3.x and other insecure libs
  • The official Crowi status is
• Convenient
  • Support LDAP Authentication
  • Slack Incoming Webhooks Integration
  • Miscellaneous features
• Docker Ready
• Docker Compose Ready
  • Multiple sites example
  • HTTPS(with Let's Encrypt) proxy integration example
• Support IE11 (Experimental)
• Developer-friendly
  • Less compile time
  • LiveReload separately available by server/client code change
  • Exclude Environment-dependency (confirmed to be developable on Win/Mac/Linux)

Check it out all additional features from here.

Quick Start for Production

Using Heroku

1. Go to https://heroku.com/deploy
2. (Optional) Input INSTALL_PLUGINS to install plugins

Using docker-compose

git clone https://github.com/weseek/crowi-plus-docker-compose.git crowi-plus
cd crowi-plus
docker-compose up

See also weseek/crowi-plus-docker-compose

On-premise

Migration Guide from Official Crowi is here.

Dependencies

• node 6.x (DON'T USE 7.x)
• npm 4.x (DON'T USE 5.x)
• yarn
• MongoDB 3.x

See confirmed versions.

Optional Dependencies

• Redis 3.x
• ElasticSearch 5.x (needed when using Full-text search)
  • CAUTION: Following plugins are required
    • Japanese (kuromoji) Analysis plugin
    • ICU Analysis Plugin

Start

Build and run the app

git clone https://github.com/weseek/crowi-plus.git
cd crowi-plus
yarn
MONGO_URI=mongodb://MONGO_HOST:MONGO_PORT/crowi npm start

DON'T USE npm install, use yarn instead.

If you launch crowi-plus with Redis and ElasticSearch, add environment variables before npm start like following:

export MONGO_URI=mongodb://MONGO_HOST:MONGO_PORT/crowi
export REDIS_URL=redis://REDIS_HOST:REDIS_PORT/crowi
export ELASTICSEARCH_URI=http://ELASTICSEARCH_HOST:ELASTICSEARCH_PORT/crowi
npm start

For more info, check Developers Guide and the official documents.

Command details

|command|desc| |--|--| |npm run build:prod|Build the client| |npm run server:prod|Launch the server| |npm start|Invoke npm run build:prod and npm run server:prod|

Upgrade

git pull
yarn
npm start

Install plugins

• Stop server if running
• yarn add to install plugin or npm install --save
  • Don't forget --save option if you use npm or crowi-plus doesn't detect plugins
• npm start to build client app and start server

Example

yarn add crowi-plugin-lsx
npm start

Getting Started to Develop

Build and Run the app

1. clone this repository
2. yarn global add npm@4 to install required global dependencies
3. yarn to install all dependencies
   • DON'T USE npm install
4. npm run build to build client app
5. npm run server to start the dev server
6. Access to http://0.0.0.0:3000

For more info, read Developers Guide on Wiki.

Documentation

• github wiki pages
  • Questions and Answers
  • Migration Guide from Official Crowi
  • Developers Guide

Contributing

Found a Bug?

If you find a bug in the source code, you can help us by submitting an issue to our GitHub Repository. Even better, you can submit a Pull Request with a fix.

Missing a Feature?

You can request a new feature by submitting an issue to our GitHub Repository. If you would like to implement a new feature, please submit an issue with a proposal for your work first, to be sure that we can use it. Please consider what kind of change it is:

• For a Major Feature, first open an issue and outline your proposal so that it can be discussed. This will also allow us to better coordinate our efforts, prevent duplication of work, and help you to craft the change so that it is successfully accepted into the project.
• Small Features can be crafted and directly submitted as a Pull Request.

Language

Write issues and PRs in English or Japanese.

Discussion

If you have something to ask or want to discuss, join to our Slack team and talk about anything, anytime.

License

• The MIT License (MIT)
• See LICENSE file.