💾 Archived View for gemini.schuhardt.net › loxy.gmi captured on 2023-01-29 at 02:15:17. Gemini links have been rewritten to link to archived content

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

The Loxy Proxy

Here is a live example (this capsule)

Documentation and source code are on my GitHub page

Loxy is a Gemini-to-HTTP proxy service written using ASP.NET Core 6.0.

Usage

Execute the 'loxy' binary to start the service.

./loxy --remote=gemini.circumlunar.space

Executing the binary without specifying a remote URI argument will result a usage page being shown in response to web requests.

Various command-line arguments can be used to configure the proxy, and are described below.

Configuration

The following are the typical command-line arguments that you'll use to configure Loxy.

Note that because Loxy is built upon the ASP.NET Core framework, there are many more options for configuration than those shown here. See documentation here and here.

Command-line Arguments

-u|--remote - The remote Gemini URI to which requests will be proxied. This should correspond to the primary capsule that you want to serve. Omitting this argument will result in this usage page being shown in response to each request. Note that other capsules will be served from the /lxy/external path.
-r|--root - A path to a filesystem directory from which to serve static content.
-s|--stylesheet - A path to a CSS file within Content Root that will be linked on each response page. Only used if Content Root is set.
-j|--script - A path to a Javascript file within Content Root that will be included on each response page. Only used if Content Root is set.
-p|--port - The network port to listen on. Default is 8080.