 |
<- Back |
 |
|
|
|
|
# OpenBSD httpd, slowcgi and cgit |
|
|
|
Last modification on 2021-04-11 |
|
|
 |
This is a guide to get »cgit« working with |
|
»OpenBSD httpd(8)« and |
|
»slowcgi(8)« in base. OpenBSD httpd is very simple to setup, but nevertheless |
|
this guide might help someone out there. |
|
|
|
|
|
## Installation |
|
|
|
Install the cgit package: |
|
|
|
# pkg_add cgit |
|
|
|
or build it from ports: |
|
|
|
# cd /usr/ports/www/cgit && make && make install |
|
|
|
|
|
## Configuration |
|
|
|
### httpd |
|
|
|
An example of »httpd.conf(5)«: |
 |
httpd.conf. |
|
|
|
|
|
### slowcgi |
|
|
|
By default the slowcgi UNIX domain socket is located at: |
|
/var/www/run/slowcgi.sock. For this example we use the defaults. |
|
|
|
|
|
### cgit |
|
|
|
The cgit binary should be located at: /var/www/cgi-bin/cgit.cgi (default). |
|
|
|
cgit uses the $CGIT_CONFIG environment variable to locate its config. By |
|
default on OpenBSD this is set to /conf/cgitrc (chroot), which is |
|
/var/www/conf/cgitrc. An example of the cgitrc file is here: »cgitrc«. |
|
|
|
In this example the cgit cache directory is set to /cgit/cache (chroot), which |
|
is /var/www/cgit/cache. Make sure to give this path read and write permissions |
|
for cgit (www:daemon). |
|
|
|
In the example the repository path (scan-path) is set to /htdocs/src (chroot), |
|
which is /var/www/htdocs/src. |
|
|
|
The footer file is set to /conf/cgit.footer. Make sure this file exists or you |
|
will get warnings: |
|
|
|
# >/var/www/conf/cgit.footer |
|
|
|
Make sure cgit.css (stylesheet) and cgit.png (logo) are accessible, by default: |
|
/var/www/cgit/cgit.{css,png} (location can be changed in httpd.conf). |
|
|
|
To support .tar.gz snapshots a static gzip binary is required in the chroot |
|
/bin directory: |
|
|
|
cd /usr/src/usr.bin/compress |
|
make clean && make LDFLAGS="-static -pie" |
|
cp obj/compress /var/www/bin/gzip |
|
|
|
|
|
## Running the services |
|
|
|
Enable the httpd and slowcgi services to automatically start them at boot: |
|
|
|
# rcctl enable httpd slowcgi |
|
|
|
Start the services: |
|
|
|
# rcctl start httpd slowcgi |
