Differences between revisions 4 and 14 (spanning 10 versions)
⇤ ← Revision 4 as of 2020-03-03 20:35:11 →
Size: 3835
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:
'''NGINX''' can run a 'good-enough' web server with minimal configuration. 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:
'''certbot''' can quickly and freely encrypt the wiki, using its NGINX plugin. 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 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 49: Line 44:

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



See [[UWSGISetup|here]] for more details on setting up uWSGI.		 === Container ===
Line 64: Line 53:
== MoinMoin == == Configuration ==
Line 68: Line 57:
=== Python Dependencies === === Preparing to Run ===
Line 70: Line 59:
To insulate the !MoinMoin instance from the wider web server, it should be installed inside a virtual environment. !MoinMoin expects a specific directories and scripts. Unpack these from the downloaded package.
Line 73: 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 78: 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
}}}



=== Minimum Running Configuration ===

In order to run, !MoinMoin expects a specific directories and scripts. Unpack these from the downloaded 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 108: 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 118: Line 81:
socket = /var/www/moin/moin.sock
chmod-socket = 660		 socket = :9000
Line 122: 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 134: Line 96:
=== Permissions === === Running the First Time ===
Line 136: 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.

----



== Configuration ==

Follow the on-screen instructions to setup a superuser, install language packs and addons, and set the front page.		 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)