Categories
WebOps

How to install and configure private MoinMoin wiki

Install and configure a private instance of the MoinMoin wiki engine, a full-featured and extensible wiki software written in Python that can store personal notes, knowledge base, or simply share interests.

MoinMoin
Private MoinMoin instance

MoinMoin installation

Update package index.

$ sudo apt-get update

Create a system user for the MoinMoin application.

$ sudo useradd -s /usr/sbin/nologin -r moinmoin

Install pip the Python package management system.

$ sudo apt-get install python-pip

Install virtualenv a tool to create isolated Python environments.

$ sudo pip install virtualenv

Create an application directory.

$ sudo mkdir -p /srv/moin-private

Download the MoinMoin source code to the created directory.

$ sudo wget --directory-prefix=/srv/moin-private http://static.moinmo.in/files/moin-1.9.9.tar.gz

Extract the downloaded source code.

$ sudo tar -xvzf /srv/moin-private/moin-1.9.9.tar.gz --directory /srv/moin-private

Create a new virtual environment.

$ sudo virtualenv /srv/moin-private/python-env

Execute the installer using the created virtual environment.

$ sudo bash -c "cd /srv/moin-private/moin-1.9.9/ && /srv/moin-private/python-env/bin/python2 setup.py install"

Copy wiki directory.

$ sudo cp -r /srv/moin-private/moin-1.9.9/wiki /srv/moin-private/

Copy wikiconfig.py configuration file.

$ sudo cp /srv/moin-private/wiki/config/wikiconfig.py /srv/moin-private/wiki/

Install uWSGI package and the Python plugin.

$ sudo apt-get install uwsgi uwsgi-plugin-python

Configure Python interpreter for the MoinMoin application using uWSGI.

$ cat <<EOF | sudo tee /etc/uwsgi/apps-available/moin-python.ini
[uwsgi]
plugins=python
uid=moinmoin
gid=moinmoin
#socket=/var/run/uwsgi/app/moin-python/socket
chown-socket=www-data
wsgi-file=/srv/moin-private/wiki/server/moin.wsgi
processes=4
vacuum=true
memory-report
virtualenv=/srv/moin-private/python-env/
python-path=/srv/moin-private/wiki
EOF

Enable the MoinMoin application.

$ sudo ln -s /etc/uwsgi/apps-available/moin-python.ini /etc/uwsgi/apps-enabled/

Change application permissions.

$ sudo chown -R moinmoin:moinmoin /srv/moin-private

Restart uWSGI.

$ sudo systemctl restart uwsgi

Install nginx server.

$ sudo apt-get install nginx

Disable default Nginx site.

$ sudo unlink /etc/nginx/sites-enabled/default

Create a directory to store the SSL certificate.

$ sudo mkdir /etc/nginx/ssl

Generate a self-signed SSL certificate for your domain.

$ sudo openssl req -subj "/commonName=private-moinmoin.example.org/" -x509 -nodes -days 730 -newkey rsa:2048 -keyout /etc/nginx/ssl/nginx.key -out /etc/nginx/ssl/nginx.crt

Configure virtual host for the MoinMoin application.

$ cat <<EOF | sudo tee /etc/nginx/sites-available/moin
server {
  listen 443 ssl;
  server_name default;

  ssl_certificate_key /etc/nginx/ssl/nginx.key;
  ssl_certificate     /etc/nginx/ssl/nginx.crt;

  location / {
      include uwsgi_params;
      uwsgi_pass unix:///var/run/uwsgi/app/moin-python/socket;
      uwsgi_modifier1 30;
  }
}
EOF

Enable configured site.

$ sudo ln -s /etc/nginx/sites-available/moin /etc/nginx/sites-enabled/

Reload nginx configuration.

$ sudo systemctl reload nginx

MoinMoin configuration

Log in to the application using a web browser and add a new user.

Set created user as a superuser (superuser directive).

$ sudo -u moinmoin sed  -i -e "s/#superuser = \[u\"YourName\", \]/superuser = [u\"milosz\", ]/" /srv/moin-private/wiki/wikiconfig.py

Log in to the application using a web browser and perform language setup.

Define the site name (sitename directive).

$ sudo -u moinmoin sed -i -e "/sitename = / s/Untitled Wiki/Private Wiki/" /srv/moin-private/wiki/wikiconfig.py

Uncomment default front page name (page_front_page directive).

$ sudo -u moinmoin sed -i -e "/#page_front_page = u\"FrontPage\"/ s/#//" /srv/moin-private/wiki/wikiconfig.py

Define default ACLs (acl_rights_before and acl_rights_default directives) to grant every right to the created user and
remove these from other users.

$ cat <<EOF | sudo -u moinmoin tee -a /srv/moin-private/wiki/wikiconfig.py
    # ACL/superadmin
    acl_rights_before = u"milosz:read,write,delete,revert,admin"
    # ACL/default (logged in users are *known*, everyone else is *all*)
    acl_rights_default = u'Known: All:'

EOF

Disable newaccount action (actions_excluded directive) to disable creating accounts for new users.

$ cat <<EOF | sudo -u moinmoin tee -a /srv/moin-private/wiki/wikiconfig.py
    # stop new accounts being created
    # https://moinmo.in/FeatureRequests/DisableUserCreation
    import MoinMoin.config.multiconfig # if not already included in your config file
    actions_excluded = MoinMoin.config.multiconfig.DefaultConfig.actions_excluded + ['newaccount']

EOF
MoinMoin
Disabled newaccount action

Additional information