openbsd-httpd-and-cgit - www.codemadness.org - www.codemadness.org saait content files
(HTM) git clone git://git.codemadness.org/www.codemadness.org
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
openbsd-httpd-and-cgit (3869B)
---
1 1<- Back / codemadness.org 70
2 i codemadness.org 70
3 i codemadness.org 70
4 i# OpenBSD httpd, slowcgi and cgit codemadness.org 70
5 i codemadness.org 70
6 iLast modification on 2021-04-11 codemadness.org 70
7 i codemadness.org 70
8 hThis is a guide to get »cgit« working with URL:https://git.zx2c4.com/cgit/ codemadness.org 70
9 h»OpenBSD httpd(8)« and URL:https://man.openbsd.org/httpd.8 codemadness.org 70
10 h»slowcgi(8)« in base. OpenBSD httpd is very simple to setup, but nevertheless URL:https://man.openbsd.org/slowcgi.8 codemadness.org 70
11 ithis guide might help someone out there. codemadness.org 70
12 i codemadness.org 70
13 i codemadness.org 70
14 i## Installation codemadness.org 70
15 i codemadness.org 70
16 iInstall the cgit package: codemadness.org 70
17 i codemadness.org 70
18 i # pkg_add cgit codemadness.org 70
19 i codemadness.org 70
20 ior build it from ports: codemadness.org 70
21 i codemadness.org 70
22 i # cd /usr/ports/www/cgit && make && make install codemadness.org 70
23 i codemadness.org 70
24 i codemadness.org 70
25 i## Configuration codemadness.org 70
26 i codemadness.org 70
27 i### httpd codemadness.org 70
28 i codemadness.org 70
29 hAn example of »httpd.conf(5)«: URL:https://man.openbsd.org/httpd.conf.5 codemadness.org 70
30 0httpd.conf. /downloads/openbsd-httpd/httpd.conf codemadness.org 70
31 i codemadness.org 70
32 i codemadness.org 70
33 i### slowcgi codemadness.org 70
34 i codemadness.org 70
35 iBy default the slowcgi UNIX domain socket is located at: codemadness.org 70
36 i/var/www/run/slowcgi.sock. For this example we use the defaults. codemadness.org 70
37 i codemadness.org 70
38 i codemadness.org 70
39 i### cgit codemadness.org 70
40 i codemadness.org 70
41 iThe cgit binary should be located at: /var/www/cgi-bin/cgit.cgi (default). codemadness.org 70
42 i codemadness.org 70
43 icgit uses the $CGIT_CONFIG environment variable to locate its config. By codemadness.org 70
44 idefault on OpenBSD this is set to /conf/cgitrc (chroot), which is codemadness.org 70
45 0/var/www/conf/cgitrc. An example of the cgitrc file is here: »cgitrc«. /downloads/openbsd-httpd/cgitrc codemadness.org 70
46 i codemadness.org 70
47 iIn this example the cgit cache directory is set to /cgit/cache (chroot), which codemadness.org 70
48 iis /var/www/cgit/cache. Make sure to give this path read and write permissions codemadness.org 70
49 ifor cgit (www:daemon). codemadness.org 70
50 i codemadness.org 70
51 iIn the example the repository path (scan-path) is set to /htdocs/src (chroot), codemadness.org 70
52 iwhich is /var/www/htdocs/src. codemadness.org 70
53 i codemadness.org 70
54 iThe footer file is set to /conf/cgit.footer. Make sure this file exists or you codemadness.org 70
55 iwill get warnings: codemadness.org 70
56 i codemadness.org 70
57 i # >/var/www/conf/cgit.footer codemadness.org 70
58 i codemadness.org 70
59 iMake sure cgit.css (stylesheet) and cgit.png (logo) are accessible, by default: codemadness.org 70
60 i/var/www/cgit/cgit.{css,png} (location can be changed in httpd.conf). codemadness.org 70
61 i codemadness.org 70
62 iTo support .tar.gz snapshots a static gzip binary is required in the chroot codemadness.org 70
63 i/bin directory: codemadness.org 70
64 i codemadness.org 70
65 i cd /usr/src/usr.bin/compress codemadness.org 70
66 i make clean && make LDFLAGS="-static -pie" codemadness.org 70
67 i cp obj/compress /var/www/bin/gzip codemadness.org 70
68 i codemadness.org 70
69 i codemadness.org 70
70 i## Running the services codemadness.org 70
71 i codemadness.org 70
72 iEnable the httpd and slowcgi services to automatically start them at boot: codemadness.org 70
73 i codemadness.org 70
74 i # rcctl enable httpd slowcgi codemadness.org 70
75 i codemadness.org 70
76 iStart the services: codemadness.org 70
77 i codemadness.org 70
78 i # rcctl start httpd slowcgi codemadness.org 70
79 .