Castor is a gemini-protocol server.
Go to file
David e979173b16
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Merge pull request 'Update golang Docker tag to v1.22' (#7) from renovate/golang-1.x into master
Reviewed-on: #7
2024-06-09 14:50:27 +00:00
certificates generate certs as needed, remove unneeded interfaces 2020-09-16 14:54:56 -04:00
handlers add some request logging 2021-10-24 16:52:13 -04:00
logger split out logger into proper package 2020-09-16 15:17:54 -04:00
.gitignore add build script 2022-04-24 12:43:46 -04:00
.woodpecker.yml remove environment 2024-02-26 00:52:57 +00:00
Dockerfile Update golang Docker tag to v1.22 2024-02-07 03:01:32 +00:00
go.mod add build script 2022-04-24 12:43:46 -04:00
go.sum remove certmagic; gemini's TOFU model doesn't benefit from short-lived certs 2020-09-14 16:38:45 -04:00
main.go add some request logging 2021-10-24 16:52:13 -04:00 add .gmi type and update README 2020-09-14 16:42:18 -04:00
renovate.json Add renovate.json 2023-04-07 00:01:09 +00:00


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.