Commands to run FedWiki

The simplest way to run wiki is: - wiki --security_legacy

This will run one wiki site on port 3000 (the default) on your local network; it will be accessible to other computers on your local network by visiting **http://<ipaddress>:3000** and the **security_legacy** flag means that anybody will be able to edit the wiki; there is no login capability at all. As a non-elevated user (that is, without using the **sudo** command), you can't run services on ports lower than (maybe?) 1000, which means you can't use port 80 (standard for web browsers).

Below is a command that has several benefits (which may or may not apply to you); the various elements will be explained in the sections below. * sudo wiki -p 80 -f --admin <long string of letters/numbers> --security_type friends --cookieSecret mumble --session_duration 9999

# Elevated privileges (sudo) Preceding the command with **sudo** (and then entering your user password when prompted) will permit you to specify a port below about 1000, notably port 80 (by adding the **-p 80** parameter) which is the port a web browser will default to. (I.e., if you're running on port 80, you can simply enter the server's IP address in your web browser, without specifying a port.)

Another result when you use **sudo** is that the command will install files for the wiki in the directory **/root/.wiki** (at the root of the server's file system) as opposed to **~/.wiki** (within your home folder). If you're just getting started, that's no big deal; if you've already built up content without sudo that you want to keep, you'll want to move it over.

# The admin flag The **admin** flag means that when you log into the wiki, you will be able to do things that change more sensitive files on the server from within the wiki software. For instance, the **plugmatic** system that allows you to install and update plugins. To do this, you have to use the same string of text and numbers ("key") in the initial command, and when logging in. (I'm not sure how you generate the key.)

# Security options One step up from **security_legacy** is: - --security_friends This means that the wiki will not be writable unless somebody enters the key (the same key as above, specified with the **admin** flag). You can give this to your "friends" and if somebody doesn't know it, they can't edit the wiki. (This is pretty minimal security though, and not something you should rely on too heavily. A dedicated hacker who has read access to the wiki might be able to guess the key.)

# Cookies **--cookieSecret mumble** I need a refresher on what this one means. I think it has to do with using cookies to preserve login sessions and authentication keys across browser sessions.

# Session duration By setting **--session_duration 9999** you ensure that each browser session will last for 9999 days (or something like that) -- that is, browser sessions do not get arbitrarily cut short forcing a new login. (I could use further clarification on this too.)