Setting up trac wiki

This document describes how to set up a Trac wiki. It is based on alpine 1.10.6 and should also be compatible with newer version.

General notes on this tutorial

In this tutorial we use these settings. These values will re-appear in various places in the upcoming example.
You can use whatever settings you like.

Path to project:	/var/lib/trac/myproject
Username:	tracadmin
Realm:	example.com
Password:	secret
Password file:	/var/lib/trac/myproject/users.realm

Installing Trac

apk add trac

Creating a Project Environment

Now lets initiate the environment

trac-admin /var/lib/trac/myproject initenv

Enter some project name when prompted

Configuring Authentication/Security

Create password-file

You need to create a password file containing this information

echo -n "tracadmin:example.com:secret" | md5sum >> /var/lib/trac/myproject/users.htdigest

Now you need to edit the passwordfile '/var/lib/trac/myproject/users.htdigest' and append the username and realm in plaintext.

 tracadmin:example.com:72842d9ffe3f4f63306a06756d2953ee

Note: 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 /var/lib/trac/myproject permission add tractester TRAC_ADMIN

Running/Testing the Standalone Server

Lets test if your password-file and other configurations worked as they are supposed to.
In case something is broken, this test would give you a hint on what's wrong.

tracd --port 8000 --auth=*,/var/lib/trac/myproject/users.htdigest,example.com /var/lib/trac/myproject

Try connect to trac with webbrowser on http://localhost:8000

Configuration/Startup

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

TRACD_PORT="80"
TRACD_OPTS="--auth=*,/var/lib/trac/myproject/users.htdigest,example.com /var/lib/trac/myproject"

Set ownership to be tracd

chown -R tracd:tracd /var/lib/trac

Configuration/Startup

Now you could start customizing your trac by editing '/var/lib/trac/myproject/conf/trac.ini'.

Startup

Now it's time to fire up your trac.

/etc/init.d/tracd start

Backup

To create a backup of a live TracEnvironment, simply run:

trac-admin /var/lib/trac/myproject hotcopy /path/to/backupdir

Boot

Make it start during boot.

rc-update add tracd