https://github.com/garritfra/taurus
A concurrent gemini server
https://github.com/garritfra/taurus
gemini server
Last synced: 5 months ago
JSON representation
A concurrent gemini server
- Host: GitHub
- URL: https://github.com/garritfra/taurus
- Owner: garritfra
- License: gpl-3.0
- Created: 2020-11-06T09:45:55.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-12-21T14:09:28.000Z (about 5 years ago)
- Last Synced: 2025-08-22T20:09:27.695Z (6 months ago)
- Topics: gemini, server
- Language: Python
- Homepage: https://sr.ht/~garritfra/taurus/
- Size: 90.8 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Taurus - A Concurrent Gemini Server
## Building
```sh
cargo build --release
cp target/release/taurus /usr/bin/taurus
```
## Usage
By default, taurus looks for a configuration file at `/etc/taurus/taurus.toml`. Fields that can be configured are defined in `src/config.rs`.
An example config might look like this:
```toml
# Default gemini port is 1965
port = 1965
# Your TLS certificate
certificate_file = "/etc/taurus/identity.pfx"
# Must match with the export password of the generated certificate
certificate_password = "mysecretpassword"
# Your gemini files
static_root = "/var/www/gemini"
```
You will need a TLS certificate in order to use taurus. To generate one, take a look at the section below.
## Generating a test-certificate
At the current state of the project, you need to generate a server certificate by hand. Take a look at `contrib/generate_cert.sh`, and run it.
## Testing
There is a diagnostics script at `contrib/diagnostics.py` that can be used to test the functionality of taurus.