|solderpunk 79dd948a9f Merge pull request 'Add initial systemd service example' (#3) from strega-nil/molly-brown:add-systemd into master||2 days ago|
|.gitignore||6 months ago|
|LICENSE||6 months ago|
|README.md||4 days ago|
|config.go||2 months ago|
|example.conf||1 month ago|
|handler.go||6 days ago|
|logging.go||6 months ago|
|main.go||4 days ago|
|molly-brown.service.example||4 days ago|
The Unsinkable Molly Brown: a full-featured Gemini server implemented in Go.
For more info on Gemini see https://gemini.circumlunar.space or gopher://gemini.circumlunar.space.
The easiest way for now to install Molly Brown is to use the standard
go (note I said "easiest", not "easy" - this is still a
pretty clunky manual process, sorry). Unfortunately, you have to do a
little bit of preparation for this to work (unless you're a Go
developer yourself in which case you surely already have this done)...
(you can in fact put your $GOPATH anywhere you like, but
~/go is the
go get tildegit.org/solderpunk/molly-brown. If everything goes
well, the end result of this will be that you'll have the Molly Brown
source code sitting in
and an executable binary sitting at
~/go/bin/molly-brown. If it
makes you happier or your life easier, you can copy that binary to
/usr/sbin/ or anywhere else.
In the source directory mentioned above, you should find a file named
example.conf. Copy this to
/etc/molly.conf and edit it to suit
your environment. The default values for all possible options are
specified in the file - just uncomment and change the ones which won't
work for you. All options are explained below in the Configuration
Currently Molly Brown just runs like an ordinary program, without
daemonising itself. You'll need to use another program, like the one
http://libslack.org/daemon/, to handle daemonising.
Currently Molly Brown is only integrated with systemd, so if you're
using anything else you'll have to handle getting it to start on boot up
yourself. If you are using a sufficiently right-headed operating
system, the easiest way to do this is by putting your call to
daemon (or whatever else you use) in
Setting up with systemd should be reasonably easy; copy
molly-brown.service.example from this directory to
/etc/systemd/system/molly-brown.service. Then, make any necessary
changes for your setup, and run the following:
# systemctl daemon-reload # systemctl enable molly-brown.service # systemctl start molly-brown.service
Note that Golang programs are unable to reliably change their UID once
run (a source of constant frustration to me!). So don't start it as
root, or it'll remain as root forever. Run it as
nobody, or a
molly user. Make sure that user has read access to the
TLS keys and write access to the specified log file.
The following options can be set in
Port: The TCP port to listen for connections on (default value
Hostname: The hostname to respond to requests for (default value
localhost). Requests for URLs with other hosts will result in a status 53 (PROXY REQUEST REFUSED) response.
CertPath: Path to TLS certificate in .pem format (default value
KeyPath: Path to TLS private key in .pem format (default value
DocBase: Base directory for Gemini content (default value
HomeDocBase: Requests for paths beginning with
~/username/will be looked up relative to
users). Note that Molly Brown does not look inside user's actual home directories like you may expect based on experience with other server software. Of course, you can symlink
/home/gus/public_gemini/if you want.
LogPath: Path to log file (default value
molly.log). Note that all intermediate directories must exist, Molly Brown won't create them for you.