KatLab-MiyazakiUniv / lab-wiki-growi-docker-compose

:anchor: growi-docker-compose - The fastest way to boot All-in-One GROWI

growi-docker-compose

Quick start GROWI with docker-compose

Table of Contents

1. Start
2. Upgrade
3. Migrate from crowi-plus-docker-compose
4. How to install plugins
5. NOTE: DISABLED Environment Variables
6. More convenient Examples
7. Documentation

Start

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

and access to http://localhost:3000

How to access from other than localhost

Edit docker-compose.yml and modify ports for app

Before

services:
  app:
    ports:
      - 127.0.0.1:3000:3000

After

services:
  app:
    ports:
      - 3000:3000

For High-memory environment

If you have enough memory, increase heap size for Elasticsearch with ES_JAVA_OPTS value in docker-compose.yml.

environment:
  - "ES_JAVA_OPTS=-Xms2g -Xmx2g"

Upgrade

Upgrading to v3.4.x from v3.3.x or below

see Upgrading to GROWI v3.4.x.

Upgrading app container

# go to growi-docker-compose workdir
cd growi

# stop
docker-compose stop

# remove current container and images
docker-compose rm app
docker rmi weseek/growi:3

# rebuild app container image
git pull
docker-compose build

# start
docker-compose up

Migrate from crowi-plus-docker-compose

If you have used weseek/crowi-plus docker image with docker-compose so far, please see migration document.

How to install plugins

edit Dockerfile and activate commented out lines.

Example

# install plugins if necessary
RUN echo "install plugins" \
  && yarn add \
     growi-plugin-XXX \
     growi-plugin-YYY \
  && echo "done."
# you must rebuild if install plugin at least one
RUN npm build:prod

NOTE: DISABLED Environment Variables

Followings are unchangable.

• PORT
• NODE_ENV

Followings are disabled because they are overwritten by docker-compose.yml

• MONGO_URI
• PASSWORD_SEED

Change docker-compose.yml if you need.

Others conform to weseek/growi

More convenient Examples

• Multiple sites
• HTTPS(with Let's Encrypt) proxy integration
• HackMD(CodiMD) integration
• Backup MongoDB data

Documentation

• GROWI Docs

Issues

If you have any problems or questions about this image, please contact us through a GitHub issue.

License

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