💾 Archived View for gemini.rlamacraft.uk › techGuides › geminiRaspPi.gmi captured on 2023-04-26 at 12:51:08. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Running a Gemini server on a first-gen Raspberry Pi

Here records the trials and tribulations of a lost weekend.

Most of these steps presumably work equally well on any device, minus the build of the server software.

Setup instructions

1. Download Adrian Hesketh's server software.

For the first gen raspberry pi you want the "armv6" build

Adrian Hesketh

GitHub repo

2. Certificate Generation

Run the following command to generate a key

openssl ecparam -genkey -name secp384r1 -out server.key

Run this, making sure to specify the domain of the server for the hostname when requsted

openssl req -new -x509 -sha256 -key server.key -out server.crt -days 3650

3. Create a hello world Gemini file, for testing purposes

mkdir content
echo "# Hello, World!" > content/index.gmi

4. Run the server, and make sure it all works

Be sure to change the domain to yours with this one
Once its running use your gemini client of choice to check it all works

gemini serve --domain=example.com --certFile=server.crt --keyFile=server.key --path=content

5. Create a script to simplify running

Just cd to where the server program is and run the command as it appears in step 4, calling the script "run-server.sh"

6. Tell cron to run it at startup

Run

crontab -e

And append the following

@reboot bash run-server.sh

And that's it, you're done.

~~~

Last Updated: 2020-11-29