blob: 2ee84c42045ce5851f03d2d4cfc7115bf3e338eb (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
# got (Game of Trees)
This page contains a comprehensive guide to setting up `got` and `gotwebd` on an OpenBSD server through `httpd` and `haproxy`.
For reference, you can see a **live version** [here](https://got.btxx.org).
The following assumes you have already setup an active `git` server on your OpenBSD instance.
## Installing `got`
Since `got` is a first-class citizen on OpenBSD, installation is very easy:
~~~sh
pkg_add got gotwebd
~~~
* `/var/www/got/public/`: Default location for Git repositories served by gotwebd
* `/var/www/htdocs/gotwebd/`: Directory containing HTML, CSS, and image files used by gotwebd.
* `/var/www/run/gotweb.sock`: Default location for the gotwebd listening socket.
Read more on the [official man pages](https://gameoftrees.org/gotwebd.8.html)
## Configuration
Include the following to your existing `/etc/httpd.conf` file. Be sure to change the domain and directory location to match your own.
~~~sh
types { include "/usr/share/misc/mime.types" }
server "got.btxx.org" {
listen on 127.0.0.1 port 8080
root "/htdocs/gotwebd"
location "/" {
fastcgi socket "/run/gotweb.sock"
}
}
~~~
Next create (or edit if it already exists) the main `/etc/gotwebd.conf` file:
~~~sh
server "localhost" {
repos_path "/got/public"
site_name "btxx projects"
site_owner "Bradley Taunt"
site_link "got.btxx.org"
}
~~~
**Important**: You will also need to fix permissions to avoid warnings:
~~~sh
doas mkdir -p /var/www/got/tmp
doas chown www:daemon /var/www/got/tmp
~~~
You may also be required to give user `www` access to the main `htdocs/gotwebd` directory:
~~~sh
doas chown www:www /var/www/htdocs/gotwebd`
~~~
## Running Our Services
Now we simply run and enable all our required services:
~~~sh
doas rcctl enable httpd slowcgi gotwebd
doas rcctl start httpd slowcgi gotwebd
~~~
**And you should be good to go!**
|
