Title: Run your Gemini server on Guix with Agate

	Title: Run your Gemini server on Guix with Agate
	Author: Solène
	Date: 17 June 2021
	Tags: guix gemini
	Description:

	# Introduction

	This article is about deploying the Gemini server agate on the Guix
	linux distribution.

	Gemini quickstart to explain Gemini to beginners
	Guix website

	# Configuration

	Guix manual about web services, search for Agate.

	Add the agate-service definition in your /etc/config.scm file, we will
	store the Gemini content in /srv/gemini/content and store the
	certificate and its private key in the upper directory.

	```Guix configuration file
	(service agate-service-type
	(agate-configuration
	(content "/srv/gemini/content")
	(cert "/srv/gemini/cert.pem")
	(key "/srv/gemini/key.rsa"))
	```

	If you have something like %desktop-services or %base-services, you
	need to wrap the services list a list using "list" function and add the
	%something-services to that list using the function "append" like this.

	```Guix configuration file
	(services
	(append
	(list (service openssh-service-type)
	(service agate-service-type
	(agate-configuration
	(content "/srv/gemini/content")
	(cert "/srv/gemini/cert.pem")
	(key "/srv/gemini/key.rsa"))))
	%desktop-services))

	```

	# Generating the certificate

	- Create directories /srv/gemini/content
	- run the following command in /srv/gemini/

	```
	openssl req -x509 -newkey rsa:4096 -keyout key.rsa -out cert.pem -days 3650 -no…
	```

	- Apply a chmod 400 on both files cert.pem and key.rsa
	- Use "guix system reconfigure /etc/config.scm" to install agate
	- Use "chown agate:agate cert.pem key.rsa" to allow agate user to read
	the certificates
	- Use "herd restart agate" to restart the service, you should have a
	working gemini server on port 1965 now

	# Conclusion

	You are now ready to publish content on Gemini by adding files in
	/srv/gemini/content , enjoy!