aboutsummaryrefslogtreecommitdiffstats
path: root/www/inks/pkg/README
diff options
context:
space:
mode:
authorla-ninpre <aaoth@aaoth.xyz>2023-04-27 01:02:53 +0300
committerla-ninpre <aaoth@aaoth.xyz>2023-04-27 01:02:53 +0300
commita8921593398f8b600e09b82a69a2c4a077785510 (patch)
tree7ffd099758732d7532a37ba45e0f0fb15d33110e /www/inks/pkg/README
parent6cdfb9b9ab548157f190e620b8da6e86afe2f95b (diff)
downloadports-a8921593398f8b600e09b82a69a2c4a077785510.tar.gz
ports-a8921593398f8b600e09b82a69a2c4a077785510.zip
www/inks: add 0.9.2pre20230325
this is not a real version, but since there were no releases for some time, i packaged the latest tip of mercurial repository and put it on my webserver.
Diffstat (limited to 'www/inks/pkg/README')
-rw-r--r--www/inks/pkg/README40
1 files changed, 40 insertions, 0 deletions
diff --git a/www/inks/pkg/README b/www/inks/pkg/README
new file mode 100644
index 0000000..dbea6ad
--- /dev/null
+++ b/www/inks/pkg/README
@@ -0,0 +1,40 @@
++-----------------------------------------------------------------------
+| Running ${PKGSTEM} on OpenBSD
++-----------------------------------------------------------------------
+
+Inks requires a working reverse proxy and https to work properly.
+Before following this guide, acquire a domain and a certificate for it
+(for example, using acme-client(1)).
+
+Then, initialize the database:
+
+$ doas su -l _inks -c 'inks init'
+
+Then type in username, password, listen address and a site name.
+The latter should be the same as your desired domain.
+
+Enable and start the inks service:
+
+$ doas rcctl enable inks && doas rcctl start inks
+
+Configure relayd(8) to forward incoming connections to local endpoint
+you specified at initialization step.
+
+Here is an example relayd(8) config:
+
+``` relayd.conf
+table <inks> { 127.0.0.1 }
+
+http protocol www {
+ tls keypair example.com
+ pass request forward to <inks>
+}
+
+relay www {
+ listen on egress port 443 tls
+ protocol www
+ forward to <inks> port 1268
+}
+```
+
+Then enable and start relayd(8).