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