Differences between revisions 2 and 14 (spanning 12 versions)
⇤ ← Revision 2 as of 2020-03-03 20:17:49 →
Size: 3681
Editor: DominicRicottone
Comment:
← Revision 14 as of 2023-04-08 20:48:33 → ⇥
Size: 2162
Editor: DominicRicottone
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
!MoinMoin is a wiki software. Version 1 (current release) runs on Python 2 with vendored dependencies, a complex plugin ecosystem, and no plan for security support. Version 2 (unstable) runs on Python 3 with the Flask ecosystem. '''!MoinMoin''' is a wiki server.

Version 1 (current release) runs on Python 2 with vendored dependencies, a complex plugin ecosystem, and no plan for security support. Version 2 (unstable) runs on Python 3 with the [[Python/Flask|Flask]] ecosystem.
Line 11: Line 13:
== Server Setup == == Installation ==
Line 13: Line 15:
!MoinMoin requires a running web server running [[PythonSetup|Python]] and [[UWSGISetup|uWSGI]]. The below walkthrough skims over security and configuration details. The source files for !MoinMoin are available for download [[http://static.moinmo.in/files|here]].
Line 17: Line 19:
=== NGINX === === Prerequisites ===
Line 19: Line 21:
Create a server location that passes into the !MoinMoin socket. then enable and start the NGINX service.

{{{
server {
        listen 80 default_server;

        access_log /var/log/nginx/access.log;
        error_log /var/log/nginx/error.log;

        location / {
                include /etc/nginx/uwsgi_params;
                uwsgi_pass unix:///var/www/moin/moin.sock;
                uwsgi_modifier1 30;
        }
}
}}}

Often, uWSGI apps recommend adding `uwsgi_modifier1 30` to rewrite PATH_INFO and SCRIPT_NAME. This is a deprecated measure, and is unstable for Python 3+. Instead, [[UWSGISetup|configure uWSGI]].

See [[NGINXSetup|here]] for more details on setting up NGINX.		 !MoinMoin depends on a `uwsgi` server. See [[Python/Uwsgi|here]] for help with installation.
Line 42: Line 25:
=== Let's Encrypt === === Virtual Environment ===
Line 44: Line 27:
Use the NGINX plugin for `certbot`. Unpack the !MoinMoin tarball into `/app/example.com`. Move into that directory, instantiate a virtual environment, and activate it. Run `python ./setup.py install`.

For `systemd`-capable systems, [[Linux/Systemd|create, start, and enable]] the following service file:
Line 47: Line 32:
sudo add-apt-repository ppa:certbot/certbot
sudo apt update
sudo apt install python-certbot-nginx
sudo certbot --nginx -d wiki.dominic-ricottone.com		 [Unit]
Description=Start uwsgi for MoinMoin wiki
After=network.target

[Service]
Type=simple
User=www-data
ExecStart=/usr/bin/uwsgi --ini /app/example.com/wiki/uwsgi.ini

[Install]
WantedBy=multi-user.target
Line 52: Line 44:

See [[SSLSetup|here]] for more details on setting up SSL.
Line 57: Line 47:
=== uWSGI ===

{{{
sudo apt install uwsgi uwsgi-plugin-python
}}}


See [[UWSGISetup|here]] for more details on setting up uWSGI.		 === Container ===
Line 70: Line 53:
== MoinMoin Setup == == Configuration ==
Line 72: Line 55:
=== Python Dependencies ===
Line 74: Line 56:
To insulate the !MoinMoin instance from the wider web server, it should be installed inside a virtual environment.
=== Preparing to Run ===

!MoinMoin expects a specific directories and scripts. Unpack these from the downloaded package.
Line 77: Line 62:
sudo apt install python-pip
sudo pip install virtualenv
sudo virtualenv /var/www/moin/pythonenv		 cp -r /tmp/wiki /app/example.com
cp /tmp/config/wikiconfig.py /app/example.com/wiki/
cp /tmp/server/moin.wsgi /app/example.com/wiki/
Line 82: Line 67:
!MoinMoin and its dependencies can now be installed safely.

{{{
#download
cd /tmp
wget http://static.moinmo.in/files/moin-1.9.10.tar.gz
tar zxvf moin-1.9.10.tar.gz
cd ./moin-1.9.10

#install
source /var/www/moin/pythonenv/bin/activate
python ./setup.py install
}}}

=== Configuration ===

Unpack key directories and files from the downloaded !MoinMoin package.

{{{
cp -r /tmp/wiki /var/www/moin
cp /tmp/config/wikiconfig.py /var/www/moin/wiki/
cp /tmp/server/moin.wsgi /var/www/moin/wiki/
}}}

Insert the below into `wikiconfig.py`, after `import os` but before `from MoinMoin.config import multiconfig, url_prefix_static`.		 Insert the below into `wikiconfig.py` after `import os` but before `from MoinMoin.config import multiconfig, url_prefix_static`.
Line 110: Line 71:
sys.path.insert(0, '/var/www/moin/pythonenv/lib/python2.7/site-packages/')
sys.path.insert(0, '/var/www/moin/wiki/')		 sys.path.insert(0, '/app/example.com/.venv/lib/python2.7/site-packages/')
sys.path.insert(0, '/app/example.com/wiki/')
Line 120: Line 81:
socket = /var/www/moin/moin.sock
chmod-socket = 660		 socket = :9000
Line 124: Line 84:
chdir = /var/www/moin/wiki
wsgi-file = /var/www/moin/wiki/moin.wsgi		 chdir = /app/example.com/wiki
wsgi-file = /app/example.com/wiki/moin.wsgi
Line 136: Line 96:
=== Permissions === === Running the First Time ===
Line 138: Line 98:
You know you'll have permissions errors eventually. Preempt them.

{{{
chown www-data:www-data -R /var/www/moin
chmod g+w,o-rwx -R /var/www/moin
}}}



=== Service File ===

Create a service file at `/etc/systemd/system/moinmoin.service`. It should call uWSGI with the configuration we just setup.

{{{
[Unit]
Description=Start uwsgi for MoinMoin wiki
After=network.target

[Service]
Type=simple
User=www-data
ExecStart=/usr/bin/uwsgi --ini /var/www/moin/wiki/uwsgi.ini

[Install]
WantedBy=multi-user.target
}}}

Enable and start the service, and enjoy your wiki!		 Follow the on-screen instructions to setup a superuser, install language packs or add-ons, and set the front page.

MoinMoin

!MoinMoin is a wiki server.

Version 1 (current release) runs on Python 2 with vendored dependencies, a complex plugin ecosystem, and no plan for security support. Version 2 (unstable) runs on Python 3 with the Flask ecosystem.

Contents

  1. MoinMoin
    1. Installation
      1. Prerequisites
      2. Virtual Environment
      3. Container
    2. Configuration
      1. Preparing to Run
      2. Running the First Time

Installation

The source files for !MoinMoin are available for download here.

Prerequisites

!MoinMoin depends on a uwsgi server. See here for help with installation.

Virtual Environment

Unpack the !MoinMoin tarball into /app/example.com. Move into that directory, instantiate a virtual environment, and activate it. Run python ./setup.py install.

For systemd-capable systems, create, start, and enable the following service file: 

[Unit]
Description=Start uwsgi for MoinMoin wiki
After=network.target

[Service]
Type=simple
User=www-data
ExecStart=/usr/bin/uwsgi --ini /app/example.com/wiki/uwsgi.ini

[Install]
WantedBy=multi-user.target

Container

Configuration

Preparing to Run

!MoinMoin expects a specific directories and scripts. Unpack these from the downloaded package. 

cp -r /tmp/wiki /app/example.com
cp /tmp/config/wikiconfig.py /app/example.com/wiki/
cp /tmp/server/moin.wsgi /app/example.com/wiki/

Insert the below into wikiconfig.py after import os but before from MoinMoin.config import multiconfig, url_prefix_static. 

import sys
sys.path.insert(0, '/app/example.com/.venv/lib/python2.7/site-packages/')
sys.path.insert(0, '/app/example.com/wiki/')

Create a new file, uwsgi.ini. 

[uwsgi]
uid = moin
gid = www-data
socket = :9000
plugin = python

chdir = /app/example.com/wiki
wsgi-file = /app/example.com/wiki/moin.wsgi

master
workers = 3
max-requests = 200
harakiri = 60
die-on-term

Running the First Time

Follow the on-screen instructions to setup a superuser, install language packs or add-ons, and set the front page.

CategoryRicottone

Python/MoinMoin (last edited 2023-04-08 20:48:33 by DominicRicottone)