Hopefully this is enough to get some folks started.
--- /dev/null
+Various example configuration files related to public-inbox
+-----------------------------------------------------------
+
+For all server admins
+---------------------
+public-inbox-config - configuration file, this maps configured inboxes
+
+For Apache2 users without Plack
+-------------------------------
+apache2_perl.conf - intended to be the basis of a production config
+
+Web server configs for quick-and-dirty demos
+--------------------------------------------
+apache2_cgi.conf - for Apache2 users who cannot install mod_perl
+cgi-webrick.rb - only for Rubyists who do not wish to install Plack or Apache
+
+Contact
+-------
+Please send any related feedback to public-inbox: meta@public-inbox.org
+Our public-inbox is: git://public-inbox.org/meta
# Example Apache2 configuration using mod_cgi
-# adjust paths to your installation
+# If possible, use mod_perl (see apache2_perl.conf) instead of this.
+# Adjust paths to your installation.
ServerName "public-inbox"
ServerRoot "/var/www/cgi-bin"
DocumentRoot "/var/www/cgi-bin"
ErrorLog "/tmp/public-inbox-error.log"
PidFile "/tmp/public-inbox.pid"
-Listen 8080
+Listen 127.0.0.1:8080
LoadModule cgi_module /usr/lib/apache2/modules/mod_cgi.so
LoadModule env_module /usr/lib/apache2/modules/mod_env.so
LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so
# Example Apache2 configuration using mod_perl2
-# adjust paths to your installation
+# Adjust paths to your installation
ServerName "public-inbox"
ServerRoot "/var/www/cgi-bin"
DocumentRoot "/var/www/cgi-bin"
ErrorLog "/tmp/public-inbox-error.log"
PidFile "/tmp/public-inbox.pid"
-Listen 8080
+Listen 127.0.0.1:8080
LoadModule perl_module /usr/lib/apache2/modules/mod_perl.so
LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so
LoadModule dir_module /usr/lib/apache2/modules/mod_dir.so
#!/usr/bin/env ruby
+# Sample configuration using WEBrick, mainly intended dev/testing
+# for folks familiar with Ruby and not various Perl webserver
+# deployment options.
require 'webrick'
require 'logger'
options = {
server = WEBrick::HTTPServer.new(options)
server.mount("/",
WEBrick::HTTPServlet::CGIHandler,
- "#{Dir.pwd}/blib/script/public-inbox.cgi")
+ "/var/www/cgi-bin/public-inbox.cgi")
['INT', 'TERM'].each do |signal|
- trap(signal) {exit}
+ trap(signal) {exit!(0)}
end
server.start