From 59a8484406cbc6bc779ebcf553db0eadd64544a5 Mon Sep 17 00:00:00 2001
From: pp-r <64266134+pp-r@users.noreply.github.com>
Date: Tue, 4 Oct 2022 10:22:18 +0200
Subject: [PATCH] Create app_gemserv.md

---
 .../10.docs/gemserv/app_gemserv.md            | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 pages/04.applications/10.docs/gemserv/app_gemserv.md

diff --git a/pages/04.applications/10.docs/gemserv/app_gemserv.md b/pages/04.applications/10.docs/gemserv/app_gemserv.md
new file mode 100644
index 00000000..33190f64
--- /dev/null
+++ b/pages/04.applications/10.docs/gemserv/app_gemserv.md
@@ -0,0 +1,60 @@
+---
+title: Gemserv
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_gemserv'
+---
+
+[![Installer Gemserv with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=gemserv) [![Integration level](https://dash.yunohost.org/integration/gemserv.svg)](https://dash.yunohost.org/appci/app/gemserv)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Gemserv* is a Gemini server written in rust.
+
+### Disclaimers / important information
+
+Please note that Gemserv uses the TCP port 1965, so you can't use it for anything else.
+
+To add a gemini capsule, create a `/etc/gemserv/config.d/example.toml` file as following:
+
+```
+[[server]]
+hostname = "yourdomain.org"
+dir = "/opt/yunohost/gemserv"
+key = "/etc/yunohost/certs/yourdomain.org/key.pem"
+cert = "/etc/yunohost/certs/yourdomain.org/crt.pem"
+# index is optional but defaults to index.gemini. The server will serve files
+# ending in gemini or gmi.
+index = "index.gmi"
+# lang is optional
+lang = "en"
+# cgi is optional bool
+cgi = true
+# cgipath is optional and only checked if cgi is true. It restricts cgi to only
+# this directory.
+cgipath = "/path/to/cgi-bin/"
+# scgi is optional
+scgi = { "/scgi" = "localhost:4000" }
+# cgienv is optional
+cgienv = { "GIT_PROJECT_ROOT" = "/srv/git" }
+# usrdir is optional. it'll look in each user's ~/public_gemini
+usrdir = true
+# proxy is optional
+# path is what comes after the hostname e.g. example.com/path
+proxy = { path = "localhost:1966" }
+# proxy_all is optional
+# It will send all requests to the specified server. It also supports streamming.
+proxy_all = "localhost:1967"
+# redirect is optional
+redirect = { "/redirect" = "/", "/newdomain" = "gemini://example.net" }
+```
+
+## Useful links
+
++ Website: [git.sr.ht/~int80h/gemserv](https://git.sr.ht/~int80h/gemserv)
++ Application software repository: [github.com - YunoHost-Apps/gemserv](https://github.com/YunoHost-Apps/gemserv_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/gemserv/issues](https://github.com/YunoHost-Apps/gemserv_ynh/issues)