Setting up trac wiki: Difference between revisions
(Setup trac using Alpine (draft - Still not finished)) |
(Cleaned up/added notes) |
||
Line 22: | Line 22: | ||
Now lets initiate the environment | Now lets initiate the environment | ||
trac-admin /root/myproject initenv | trac-admin /root/myproject initenv | ||
* Enter some project name when prompted | |||
'''Important:''' When prompted about svn, don't enter any value!<BR> | |||
Alpine-1.7.29 is missing svn support for trac (standard svn support works though). | |||
== Configuring Authentication/Security == | == Configuring Authentication/Security == | ||
Line 44: | Line 47: | ||
For some reason it seems we need to manually test ''tracd'' before using the init.d script.<BR> | For some reason it seems we need to manually test ''tracd'' before using the init.d script.<BR> | ||
Might be some files are created at first run - that's needed by the init.d script (not sure about this though). | 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 | tracd --port 8000 --auth=*,/root/myproject/users.htdigest,mycompany.com /root/myproject | ||
If all looks ok you can proceed with this wiki. | If all looks ok you can proceed with this wiki. | ||
Line 55: | Line 58: | ||
'''''Note:''' Above user/group should probably not be 'root'. Changing this later on'' | '''''Note:''' Above user/group should probably not be 'root'. Changing this later on'' | ||
== Configuration/Startup == | |||
Now you could start customizing your trac by editing '/root/myproject/conf/trac.ini'. | |||
== TODO == | == TODO == | ||
* Make link to this document from the 'Documentation' page | * Make link to this document from the 'Documentation' page |
Revision as of 08:49, 31 December 2008
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
- Enter some project name when prompted
Important: When prompted about svn, don't enter any value!
Alpine-1.7.29 is missing svn support for trac (standard svn support works though).
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 --auth=*,/root/myproject/users.htdigest,mycompany.com /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
Configuration/Startup
Now you could start customizing your trac by editing '/root/myproject/conf/trac.ini'.
TODO
- Make link to this document from the 'Documentation' page