2020-02-21 16:13:54 -05:00
|
|
|
# SecretShop: a small Gemini server.
|
2020-02-12 20:29:32 -05:00
|
|
|
|
2020-02-21 16:13:54 -05:00
|
|
|
## Features
|
2020-02-19 15:26:46 -05:00
|
|
|
* Multi-site hosting
|
2020-02-20 17:03:34 -05:00
|
|
|
* Also supports simple Gopher hosting
|
2020-02-12 20:52:11 -05:00
|
|
|
* Fully compliant with Jetforce diagnostics
|
|
|
|
* Probably won't kill your computer
|
2020-02-12 20:29:32 -05:00
|
|
|
|
2020-02-21 16:13:54 -05:00
|
|
|
## Configuration
|
2020-02-12 20:29:32 -05:00
|
|
|
SecretShop looks in it's current running directory and /etc/secretshop for it's config file.
|
|
|
|
Configuration is in config/yaml in one of the above directories. See the sample config for more details
|
|
|
|
but a standard file looks like such:
|
|
|
|
|
2020-02-21 16:13:54 -05:00
|
|
|
---
|
2020-02-22 16:17:38 -05:00
|
|
|
port: 1965
|
2020-02-21 16:13:54 -05:00
|
|
|
active_capsules:
|
|
|
|
- localhost
|
|
|
|
localhost:
|
|
|
|
Hostname: "localhost"
|
|
|
|
Port: "1965"
|
|
|
|
RootDir: "/var/gemini"
|
|
|
|
CGIDir: "/var/gemini/cgi"
|
|
|
|
KeyFile: "localhost.key"
|
|
|
|
CertFile: "localhost.crt"
|
2020-02-12 20:29:32 -05:00
|
|
|
|
2020-02-22 16:17:38 -05:00
|
|
|
Where each "active_capsule" is a virtual Gemini capsule. SecretShop supports virtual Gemini capsules all listening on port 1965
|
|
|
|
as well as multiple Gopher servers runnning (though not virtual Gopher hosts due to protocol limitations)
|
|
|
|
|
2020-02-19 15:56:32 -05:00
|
|
|
Please note that CGIDir currently not used (waiting on spec clarification).
|
2020-02-12 20:29:32 -05:00
|
|
|
|
2020-02-21 16:13:54 -05:00
|
|
|
## Building
|
|
|
|
Running "make" should work for any given x86 machine.
|
|
|
|
|
|
|
|
If you're planning on running this on a Raspberry Pi or other ARM machine try
|
|
|
|
env GOOS=linux GOARCH=arm GOARM=5 make
|
|
|
|
|
|
|
|
## Installation
|
2020-02-21 16:10:08 -05:00
|
|
|
Running "make install" will install to /usr/local/bin by default.
|
|
|
|
|
|
|
|
Running "make service" will install to /usr/local/bin and also install the systemd service file
|
|
|
|
|
2020-02-21 16:13:54 -05:00
|
|
|
## Uninstall
|
|
|
|
Simply run "make uninstall".
|
2020-02-21 16:10:08 -05:00
|
|
|
|
2020-02-21 16:13:54 -05:00
|
|
|
## Running
|
2020-02-12 20:29:32 -05:00
|
|
|
Either run the executable directly or use the SystemD unit file
|