secretshop/README.md

43 lines
1.2 KiB
Markdown
Raw Normal View History

2020-02-21 21:13:54 +00:00
# SecretShop: a small Gemini server.
2020-02-13 01:29:32 +00:00
2020-02-21 21:13:54 +00:00
## Features
2020-02-19 20:26:46 +00:00
* Multi-site hosting
2020-02-20 22:03:34 +00:00
* Also supports simple Gopher hosting
2020-02-13 01:52:11 +00:00
* Fully compliant with Jetforce diagnostics
* Probably won't kill your computer
2020-02-13 01:29:32 +00:00
2020-02-21 21:13:54 +00:00
## Configuration
2020-02-13 01:29:32 +00: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 21:13:54 +00:00
---
active_capsules:
- localhost
localhost:
Hostname: "localhost"
Port: "1965"
RootDir: "/var/gemini"
CGIDir: "/var/gemini/cgi"
KeyFile: "localhost.key"
CertFile: "localhost.crt"
2020-02-13 01:29:32 +00:00
2020-02-19 20:56:32 +00:00
Please note that CGIDir currently not used (waiting on spec clarification).
2020-02-13 01:29:32 +00:00
2020-02-21 21:13:54 +00: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 21:10:08 +00: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 21:13:54 +00:00
## Uninstall
Simply run "make uninstall".
2020-02-21 21:10:08 +00:00
2020-02-21 21:13:54 +00:00
## Running
2020-02-13 01:29:32 +00:00
Either run the executable directly or use the SystemD unit file