A ready-to-use docker image for Wiki System based on Gollum with authentication. The authentication leverages Github OAuth App and controls who is able edit pages.
A ready-to-use docker image for Github-Synchronized, Markdown-based, and Authentication-Enabled Wiki System. No environment issues anymore. Get docker installed and set up your Wiki in a second!
A live demo is available here.
More details can be found in this post.
Docker images can be found here.
Create your Github wiki, clone it to some local directory. For example,
git clone https://github.com/FighterNan/FighterNan.github.io.wiki.git
Run the service on the root of your Wiki repo.
cd FighterNan.github.io.wiki
sudo docker run \
-v ${PWD}:/home/wiki_repo \
-p 4567:4567 \
-e GITHUB_CLIENT_ID=xxx \
-e GITHUB_CLIENT_SECRET=xxx \
-e [email protected] \
--name wiki \
nanzhoumails/auth_wiki:latest
There are three environment variables you should set. GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET are available once you set your Github OAuth App. See here for official tutorial. AUTH_EMAIL specifies the user who can edit the pages. Other users can only view the pages.
The original script is from here. I change the hard-coded configurations to environment varibles.