command module
v1.0.0 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Jan 2, 2021 License: AGPL-3.0 Imports: 20 Imported by: 0



Satellite is a small Gemini server for serving static files.



See satellite (1)


By default, Satellite uses /etc/satellite.toml, but a custom config file can be supplied with the -c flag.

Example configuration
# Address to listen to requests (default:
listen = ""

# Directory to save certificates
directory = "/var/lib/gemini/certs"

# Multiple domains can be set with the [[domain]] section
name = ""
root = "/srv/gemini/"

name = ""
root = "/srv/gemini/"

The SSL certificate generation will be managed by Satellite and will be automatically regenerated on the certificate expiry date.

More information on satellite.toml(5)


It depends on OpenSSL, scdoc and Go to be installed. Consult your OS system package manager to learn more about it.

$ make
$ make install

This will install a sample configuration on /usr/local/share/satellite/satellite.toml that you can later copy to /etc/satellite.toml.

Running with Docker

Build an image:

$ docker build -t satellite .

Create two directories to store certs/configuration and data served by satellite (Satellite runs under UID 1000, so we need to grant it RWX on the config dir), then run the container:

$ mkdir config
$ mkdir data
$ cat >config/satellite.toml <<EOF
directory = "/config"
name = ""
root = "/data"
$ chown 1000 config
$ chmod 700 config
$ docker run -d -p 1965:1965 -v $(pwd)/config:/config -v $(pwd)/data:/data satellite


Patches and questions? Send to my public inbox: ~gsthnz/ Thanks!


The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL