etherpad works very well on FreeBSD. Installing it is pretty straight forward and you can mostly follow “generic” Linux Howtos, but there are some differences, listed here.
Some etherpad Linux Howtos:
install:
- JDK, I use java/jdk15
- lang/scala
- mysql, I use databases/mysql51-server
- databases/mysql-connector-java
- shells/bash
- devel/mercurial
since some of the scripts use #!/bin/shell I do
otherwise you can just grep through the source later and replace all #!/bin/bash with #!/usr/local/bin/bash
make sure that CP_CMD=”/bin/cp -R -n” in etherpad/trunk/infrastructure/bin/compilecache.sh i.e. by replacing Darwin with FreeBSD in line 18 or just change line 17.
the exports are:
export SCALA_HOME="/usr/local/share/scala-2.7.7"
export JAVA="$JAVA_HOME/bin/java"
export SCALA="$SCALA_HOME/bin/scala"
export PATH="$JAVA_HOME/bin:$SCALA_HOME/bin:/usr/local/mysql/bin:$PATH"
export MYSQL_CONNECTOR_JAR="/usr/local/share/java/classes/mysql-connector-java.jar"
you might consider to add an etherpad user.
for reaching etherpad through port 80 I use apache’s mod_proxy. The configurations I found didn’t work for me, this did:
ServerName yourdomain.tld
ServerSignature Off
ErrorLog /var/log/apache2/yourdomain.tld/error.log
LogLevel warn
CustomLog /var/log/apache2/yourdomain.tld/access.log combined
ProxyRequests Off
<proxy *>
Order deny,allow
Allow from all
</proxy>
ProxyPass / http://localhost:9000/
ProxyPassReverse / http://localhost:9000/
ProxyPreserveHost on
</virtualhost>
don’t forget to load mod_proxy and mod_proxy_http
LoadModule proxy_http_module libexec/apache2/mod_proxy_http.so
if you are using apache2 and don’t have mod_proxy installed, just make it again with WITH_PROXY_MODULES=yes
make WITH_PROXY_MODULES=yes
make deinstall
make reinstall