Capsule server setup

Install the Agate server

Download the Agate server

Add content

mkdir ~/gemini && cd ~/gemini
echo "# Hello World" > index.gmi

Install a TLS certificate and a private key

mkdir -p ~/certs/gemini && cd ~/certs/gemini
openssl req -new -subj "/CN=domain-name.com" -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -days 3650 -nodes -keyout key.pem -out cert.pem 

Add an Agate service to systemd

cd /etc/systemd/system
sudo wget -O agate.service https://codeberg.org/etienne/gemini/raw/branch/main/agate-template.service

# Once downloaded, make sure you update your agate.service with correct values

Launch the Agate service

sudo systemctl start agate
sudo systemctl enable agate

You're done ! Try now to reach your Gemini capsule with a browser like Lagrange:

Lagrange browser

This guide was based on Chris Were's instructions to get an Agate server setup. Check out his capsule!

Chris Were's capsule

Troubleshooting

• Make sure port 1965 is allowed in your firewall.
• Run `sudo journalctl -f` to make sure the Agate serve does not throw any error.

(back to 💻 Tech)

(back to homepage)