💾 Archived View for gem.benscraft.info › gemcaps › internalhandlers.gmi captured on 2021-12-17 at 13:26:06. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Internal Handlers

Here you will find the documentation on internal handlers.

File

The file handler will serve static files.

Capsule Configuration

directory: Directory on disk to serve static files from
blockedPatterns: List of file pattern globs to block

Example Configuration

directory: /var/gemini/static/
documentRoot: /static/
blockedPatterns:
 - *.py

Gsgi

The Gemini Server Gateway Interface handler. This works similarly in principal to cgi, but the program is started once and acts as its own server that is being reverse-proxied to gemcaps. This allows for abstraction from tls without removing tls.

More details on gsgi can be found here

Capsule Configuration

command: A list of command line arguments that start the server
environ: A mapping of environment variables to give to the server
workingDir: The working directory to run the command in

Example Configuration

command:
 - venv/bin/python
 - -m
 - mycapsule
environ:
  documentRoot: /foo
documentRoot: /foo
workingDir: /var/gemini/mycapsule