Install Apache13 (Apache13-modssl could work but not tested)
get it up and running
install twiki from /usr/ports
get basic configuration up and running (be sure to set the mail options in TWikiPreferences)
register yourself on the twiki
Follow authentication setup instructions very carefully.
Enabling Authentication of Users
- Rename file
.htaccess.txtin thetwiki/bindirectory to.htaccessand change it to your needs. For details, consult the HTTP server documentation (for Apache server: [1], [2]). In particular, the following red part needs to be configured correctly:
Redirect /urlpathto/twiki/index.html http://yourdomain.com/urlpathto/twiki/bin/view
AuthUserFile /filepathto/twiki/data/.htpasswd
ErrorDocument 401 /urlpathto/twiki/bin/oops/TWiki/TWikiRegistration?template=oopsauth-
NOTE: If you had to add a .cgior.plfile extension to thebinscripts, make sure to do the same foredit,view,preview, and all the other script names in.htaccess. -
The browser should ask for login name and password when you click on the Edit link. In case .htaccessdoes not have the desired effect, you need to enable it: Add "AllowOverride All" to the Directory [3] section ofaccess.conffor yourtwiki/bindirectory.- This applies only if you have root access: on hosted accounts, you shouldn’t have this problem – otherwise, email tech support.
-
NOTE: In the TWiki distribution package, the twiki/data/.htpasswd.txt
file contains several TWiki core team user accounts and a guest user
account. You probably want to remove those accounts by deleting the
entries in.htpasswd. Do not remove the guest user if you want to allow guest logins.
-
- Copy the TWikiRegistrationPub topic to TWikiRegistration, overwriting old version of TWikiRegistration. Do that by either editing the topics in theTWiki web, or by renaming the
.txtand.txt,vfiles in thetwiki/data/TWikidirectory.
- You can customize the registration form by deleting or adding input tags. The
name=""parameter of the input tags must start with:"Twk0..."(if this is an optional entry), or"Twk1..."(if this is a required entry). This ensures that the fields are carried over into the user home page correctly. - You can customize the default user home page in NewUserTemplate.
-
NOTE: When a user registers, a new line with the username and encrypted password is added to the data/.htpasswdfile. The.htpasswd
file that comes with the TWiki installation includes user accounts for
TWiki core team members that are used for testing on TWiki.org. You can
edit the file and delete those lines.
That’s it for a basic new web set-up!
Finally, Inside /usr/local/etc/apache/access.conf, add:
< d i r e c t o r y /usr/local/www/twiki/bin >
AllowOverride All
< d i r e c t o r y >