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"