gollum

install and enable

gem install gollum
gem install github-markdown #required for tables

navigate to wiki dir and run gollum

gollum --css --h1-title

• using custom css file and setting first h1 header as page title
• see gollum config docs for options
• look at omnigollum for user auth
• gollum reverse proxy

running as a service

enter the following in /etc/systemd/system/gollum-personal.service

[Unit]
Description=Personal Gollum wiki server
After=network.target

[Service]
Type=simple
ExecStart=/home/pyratebeard/.gem/ruby/2.5.0/bin/gollum --show-all --live-preview --h1-title --port 4666 --css "/path/to/your/repo"
Restart=on-abort

[Install]
WantedBy=multi-user.target

installing gollum on jump-test

https://github.com/gollum/gollum # use --bare

• configure omnigollum https://github.com/arr2036/omnigollum
• using azuread https://github.com/AzureAD/omniauth-azure-activedirectory

steps

• to enable git server
  • install git (duh!)
  • create 'git' user adduser git mkdir ~git/.ssh chmod 700 ~git/.ssh touch ~git/.ssh/authorized_keys chmod 600 ~git/.ssh/authorized_keys
• mkdir 'wiki' dir mkdir /wiki chown git. /wiki
• create git repo - getting git on server su - git cd /wiki git init --bare --shared
• clone repo and initial commit (on local machine) git clone git@gitserver:/wiki wiki cd wiki/ echo "# wiki" > README.md git add README.md git commit -m "Initial commit" git push -u origin master

• install gollum

  apt install ruby ruby-dev build-essential zlib1g-dev libicu-dev
  gem install gollum
  

  yum group install "Development Tools"
  yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel
  gem install gollum
  

• enable gollum as a service

  vi /etc/systemd/system/gollum.service
  
  [Service]
  ExecStart=/usr/local/bin/gollum --show-all "/wiki"
  

• allow traffic iptables -I INPUT -p tcp --dport 4567 -j ACCEPT -m comment --comment "Allow access to wiki"