Castor is a gemini-protocol server.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
alazyreader 4d313c5e45
ci/woodpecker/push/woodpecker Pipeline failed Details
Merge pull request 'Update golang Docker tag to v1.20' (#2) from renovate/golang-1.x into master
Reviewed-on: #2
2 months ago
certificates generate certs as needed, remove unneeded interfaces 3 years ago
handlers add some request logging 2 years ago
logger split out logger into proper package 3 years ago
.gitignore add build script 1 year ago
.woodpecker.yml remove vfs 1 year ago
Dockerfile Update golang Docker tag to v1.20 2 months ago add .gmi type and update README 3 years ago
go.mod add build script 1 year ago
go.sum remove certmagic; gemini's TOFU model doesn't benefit from short-lived certs 3 years ago
main.go add some request logging 2 years ago
renovate.json Add renovate.json 2 months ago


Castor is a lightweight but full-featured gemini server, focused on ease of setup and use.

Servers are configured using Castorfiles, analogous to Caddyfiles or nginx configurations. Various handlers can be defined:

  • static file serving
  • hard-coded responses

Castorfiles also support client cert requirements; lists of client certificate hashes can be provided for authentication, or simply as session-management (hashes being passed off to a backend server for mapping to a user identity).


Castor is the second-brightest object in the zodiac constellation of Gemini and one of the brightest stars in the night sky, as well as one of a pair of twin half-brothers, along with his brother Pollux.