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