## DO NOT TRANSLATE THIS PAGE / SUBPAGES OF THIS PAGE.
##master-page:Unknown-Page
##master-date:Unknown-Date
#acl -All:write Default
#format wiki
#language en
#pragma section-numbers off

= Linux: Detailed Quick Installation =

== Download MoinMoin ==
Please read the MoinMoin:MoinMoinDownload wiki page to find and download the latest !MoinMoin release version.

(!) Please remember the path where you saved that download and also its exact filename.

The filename will likely be something like `moin-1.9.0.tar.gz` (for moin version 1.9.0), but we will just talk of moin-x.x.x because the concrete version number changes often. You have to use the real version number in the commands you enter, not x.x.x, of course.

== Working on the shell ==
For the next steps, we will work on a shell prompt (for sure you can also do all the steps using some GUI tool of your favourite desktop environment, but because of the diversity of those environments, you will have to find out the right tools yourself using these steps as a guideline).

(!) If you use some graphical desktop environment or some X Window Manager, you will first have to find a terminal window (usually called "Terminal", "XTerm", "shell", "bash", "Command line window" or similar) and start it. If you see something showing a $ and a blinking cursor to the right of it, it worked. We shall also refer to this window as the "shell".

/!\ Note that you '''must not''' use a "root shell" for this type of installation. Just use a shell as the non-priviledged user you usually log in as. You can use the `id` command to display what user you are and it must not display "root".

For the next steps, we assume you have downloaded the moin archive into your home directory and that the current directory is your home directory (that's the default when you start a shell, usually indicated by a shell prompt showing `~$` - the tilde means you are in your home directory and the dollar means that you can enter a command to the right of it).

== Verify the integrity of your downloaded file ==
Make sure the archive downloaded correctly by verifying the md5sum (a checksum) of the archive:
{{{
$ md5sum moin-x.x.x.tar.gz
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX  moin-x.x.x.tar.gz
}}}
The value (XXX...) md5sum shown left of the filename must match the value published on the download page for the file you just downloaded!

/!\ If it does not match, your download is corrupted somehow. Remove the file and try downloading it again.

== Unpack MoinMoin ==
We use a gzipped tar archive for our release archives - you need to unpack it before using.

Unpack it using this command on the shell:
{{{
$ tar xvzf moin-x.x.x.tar.gz
(it will show a long list of all files it has unpacked)
}}}

This will create a directory `moin-x.x.x` in the current directory with all the !MoinMoin release files in it.

== Run MoinMoin ==
!MoinMoin is written using the Python programming language so you need to start it using the python interpreter:
{{{
$ cd moin-x.x.x
$ python wikiserver.py
(you will see the log output of the running MoinMoin server here)
}}}

After !MoinMoin has started, it will show some log output in your terminal window. Within that logging output, it will also announce on which IP address and port the server runs (e.g. http://127.0.0.1:8080).

Now just leave that terminal window as it is and the builtin web server of !MoinMoin will work as long as you don't stop it.

You can stop the server by closing that terminal window or by pressing `Ctrl-C` to interrupt it.

== Use MoinMoin ==
Just point your web browser at the address you got from the terminal window (e.g.: http://127.0.0.1:8080/ or http://localhost:8080/ ).

You should now see your fresh moin wiki in your browser. Maybe bookmark that address so you don't have to enter it manually each time you want to use your wiki.

Your wiki is now ready to use. Have fun! :)
