[Alice]

HelpOnInstalling/StandaloneServer

The following 152 words could not be found in the dictionary of 635 words (including 635 LocalSpellingWords) and are highlighted below:

add   all   an   and   at   available   Basic   be   because   but   can   Check   chown   class   Close   command   Comment   commented   Config   config   configuration   Configuring   configuring   Control   Creation   css   default   Default   developer   did   dir   docs   documents   does   double   especially   existing   exists   file   files   fine   for   from   gid   group   home   htdocs   if   If   images   import   in   insert   install   Installation   installed   Installing   Instance   interface   interrupt   just   like   line   Linux   listen   local   localhost   Log   log   Mac   made   meant   might   must   necessary   need   needed   new   Only   only   opened   Option   options   or   other   Password   Path   path   personal   port   Port   Posix   prefix   privileged   probably   profiler   python   Python   root   Run   run   Running   sample   section   serve   server   serving   Serving   Set   set   setup   share   shared   should   skip   standalone   standard   start   Starting   stop   sudo   sys   System   system   terminal   Test   that   them   Then   this   to   To   uid   under   Unix   used   Useful   user   usr   verify   want   web   what   where   wikiconfig   will   window   Windows   with   You   you   your  

Clear message

Installing and configuring standalone server for a personal wiki

The standalone server is especially made for local wikis because it does not need a web server installed. Only Python and Moin are necessary!

First do ../BasicInstallation and ../WikiInstanceCreation (home dir setup). Then copy moin.py to your wiki directory, where your wikiconfig.py is.

Configuring moin.py

System path configuration

If you did a standard install, and you are not a developer, you probably want to skip this section. If not, you might want to add the path to moin and config file, like that:

import sys
sys.path.insert(0, '/path/to/moin')
sys.path.insert(0, '/path/to/wikiconfig')

Config class options

If you did a standard install, the default options might be just what you need. Check and change what you like:

Option

Default

Comment

docs

'/usr/share/moin/wiki/htdocs'

Path to moin shared files

user

'www-data'

If you run as root, the server will run with as this user

group

'www-data'

If you run as root, the server will run with as this group

port

8000

Port to serve. To serve privileged port under 1024 you will have to run as root

interface

'localhost'

The interface the server will listen to. The default will listen only to localhost. Set to to listen to all.

logPath

'moin.log'

Log file. Default is commented.

profiler

commented python code

Useful only if you are a moin developer.

Configuring wikiconfig.py

The sample config file should be just fine.

Option

Default

Comment

url_prefix

'/wiki'

You should not change this, or images and css file will not be available to the wiki!

Starting the server

Run moin.py from the command line:

$ ./moin.py
Serving on localhost:8000, documents in '/usr/share/moin/wiki/htdocs'

Test your wiki at [WWW] http://localhost:8000/

To stop the server, interrupt it with Control + C.

On Windows, you can double click moin.py to start the server. A new terminal window will be opened. Close the window to stop the server.

Serving port 80 on Unix

On GNU/Linux, Mac OS X or other Posix like OS, you can serve the standard port 80 used for web serving, but you must run as root for this.

Set port to 80, and verify that user and group exists on your system. If not, set them to an existing user, meant for web serving. If needed, chown your wiki dir to this user and group.

Run moin.py as root:

$ sudo moin.py
Password:
Running as uid/gid 70/70
Serving on localhost:80, documents in '/usr/share/moin/wiki/htdocs'

Test your wiki at [WWW] http://localhost/