Setting up trac wiki

Initial Setup

This document is based on alpine-1.7.29 and should also be compatible with newer version of Alpine.

Note: Follow Installing Alpine instructions on how to setup Alpine

Installing programs

 apk_add trac
 apk_add python
 apk_add python-dev
 apk_add setuptools
 apk_add sqlite

Note: Above packages might end up as dependencies to trac (mentioning them as a reminder for now)

Installing Trac

 easy_install trac

Creating a Project Environment

In this tutorial we use these settings

Path to project: /root/myproject

Now lets initiate the environment

 trac-admin /root/myproject initenv

Configuring Authentication/Security

In this example...

Lets assume you want to use

Username: tractester
Realm: mycompany.com
Password: secret

Create password-file

You need to create a password file containing this information

 echo -e "tractester:mycompany.com:secret\c" | md5sum - >> /root/myproject/users.htdigest

Now you need to edit the passwordfile /root/myproject/users.htdigest and app the username and realm in plaintext.

 tractester:mycompany.com:65f5e135c5ed43b1a1340a3188062fd6

Important: Note that you need to remove the "-" and whitespaces at the end of the row!

Admin-rights

Next is to give admin-rights to your 'tractester' account

 trac-admin /root/myproject permission add tractester TRAC_ADMIN

Running/Testing the Standalone Server

For some reason it seems we need to manually test tracd before using the init.d script.
Might be some files are created at first run - that's needed by the init.d script (not sure about this though).

 tracd --port 8000 /root/myproject

If all looks ok you can proceed with this wiki.

Configuration/Startup

Edit /etc/conf.d/tracd and configure your variables

TRACD_PORT="80"
TRACD_OPTS="--auth=*,/root/myproject/users.htdigest,mycompany.com /root/myproject"
TRACD_USER="root"
TRACD_GROUP="root"

Note: Above user/group should probably not be 'root'. Changing this later on

TODO

Walk trough these wiki-notes and see what is wrong.
Add notes on howto get svn working
Make link to this document from the 'Documentation' page