Table of contents

Standard configuration


Raspberry-Ciwiki Pi is preinstalled and already preconfigured. But you can customize the email message sent to the new users and more.

As soon as the ethernet cable (RJ-45) is plugged to your router and your Raspberry-Ciwiki, your wiki server is ready to serve wiki pages on your intranet network.

Advanced configuration


Login


The server (Raspberry Pi)

The client

Space are not allowed, any other chars are possible. The other fields (email,code) are only used to open an account.

are stored in ~/newwikiusers.txt , for example:
U:Gladiator P:Extrem125 M:inphilly@gmail.com I:127.0.0.1 T:21151948 C:43b002e6240

The user "Gladiator" will have to be contacted by email "yourlogin@gmail.com" with these infos:
username "Gladiator" password "Extrem125" and access code "43b002e6240"

and create a file .unwanted.txt (don't forget the dot to hide the file else that will not work) and write one line for each forbidden ip.

LOGIN FEATURES:

Note: If after 30mn a page has not been opened then the ip is canceled, and the user will have to login again.

Automatic mailing of the access code


If the registration mail is not sent:

ssmtp configuration , example of configuration for gmail:

  1. $sudo nano /etc/ssmtp/ssmtp.conf

mailhub=smtp.gmail.com:587
UseSTARTTLS=YES
FromLineOverride=YES
AuthUser=yourlogin@gmail.com
AuthPass=yourpassword

  1. $sudo nano /etc/ssmtp/revaliases

root:yourlogin@gmail.com:smtp.gmail.com:587
localusername:yourlogin@gmail.com:smtp.gmail.com:587

Permission files


Permission files are located in the folder /.ciwiki/permission

The file .login.txt contains the registered users:
NAME     ENCRYPTED PASSWORD INET Adr    DATE   FLAGS
newroanne 000b53add24d1e41  127.0.0.1 21248396 1 1

The file '.session.txt' contains the users curently logged:

-----INET ADR AUTHORIZED--------:---LOGIN DATE---:--------USER NAME-------
            127.0.0.1:        21365194:                inphilly

Files .login.txt and .session.txt are automatically created and they should not be manually modified or deleted. File .session.txt is automatically deleted when the program CiWiki is closed and it's created when the first user login.

The file .alwayswanted.txt contains a list of inet address that are automatically logged on without user intervention. Write one address per line terminated with a EOL (key Enter):

192.168.1.64
192.168.1.65

The file .unwanted.txt contains a list of inet address to reject. Users with these addresses will not able to login. Write one address per line terminated with a EOL (key Enter):

192.168.1.10
192.168.1.15


Setup the wiki server


To create your little Wiki server you need to know your ip adress.

In the console, type ifconfig eth0 and record the inet adr.

For instance:

jp@jp-laptop:~$ ifconfig
eth0      Link encap:Ethernet  HWaddr 00:c0:9e:1c:77:31  
         inet adr:191.149.1.58   ...

So my inet adress is: 191.149.1.58

If ciwiki runs in default mode, the port is 8000 (use "ciwiki port xxxx" to change it). The users will have to enter in their browser this address:port 191.149.1.58:8000

Ciwiki software


Because ciwiki is wrote in C (a compiled language), ciwiki is very fast. It is about 10 time faster than any wiki in interpreted languages such as php, perl, python. Ciwiki on Raspberry Pi is able to serve hundred of wiki pages simultaneously without noticeable slow down. Ciwiki has a built-in web server, so it is very compact and does not require a lot of memory. Perfect for a nanocomputer such as the Raspberry Pi.