aboutsummaryrefslogtreecommitdiff
path: root/content/blog/2021-04-17-gemini-server.org
diff options
context:
space:
mode:
authorChristian Cleberg <[email protected]>2025-11-11 21:25:46 -0600
committerChristian Cleberg <[email protected]>2025-11-11 21:25:46 -0600
commitce7749abd0114d836d116ecbeb001d0a3827be3b (patch)
treefa74563f278197e81e8928aa322d132013b958d5 /content/blog/2021-04-17-gemini-server.org
parentaf67e996dc93ade1acd4eed47d25da55c0c63b50 (diff)
downloadcleberg.net-ce7749abd0114d836d116ecbeb001d0a3827be3b.tar.gz
cleberg.net-ce7749abd0114d836d116ecbeb001d0a3827be3b.tar.bz2
cleberg.net-ce7749abd0114d836d116ecbeb001d0a3827be3b.zip
fix grammar in 2021 posts
Diffstat (limited to 'content/blog/2021-04-17-gemini-server.org')
-rw-r--r--content/blog/2021-04-17-gemini-server.org71
1 files changed, 33 insertions, 38 deletions
diff --git a/content/blog/2021-04-17-gemini-server.org b/content/blog/2021-04-17-gemini-server.org
index b915fb6..f223822 100644
--- a/content/blog/2021-04-17-gemini-server.org
+++ b/content/blog/2021-04-17-gemini-server.org
@@ -5,28 +5,26 @@
* Similar Article Available
-To read more about Gemini and ways to test out this new protocol without
-your own server, see my previous post
-[[../launching-a-gemini-capsule/][Launching a Gemini Capsule]].
+To read more about Gemini and ways to test out this new protocol without your
+own server, see my previous post [[../launching-a-gemini-capsule/][Launching a Gemini Capsule]].
* Preparation
-This guide assumes you have access to a server accessible to the world
-through a public IP address and that you own a domain name used for this
-Gemini capsule.
+This guide assumes you have access to a server accessible to the world through a
+public IP (internet protocol) address and that you own a domain name used for
+this Gemini capsule.
* Getting Started with Agate
-We are going to use [[https://github.com/mbrubeck/agate][Agate]] for
-this tutorial. This is a basic Gemini server written in Rust. It takes
-very little time and maintenance to get it running.
+We are going to use [[https://github.com/mbrubeck/agate][Agate]] for this tutorial. This is a basic Gemini server
+written in Rust. It takes very little time and maintenance to get it running.
* Install Dependencies
-First, you will need to install the Rust package for your system. On
-Ubuntu, use the following commands (remember to use =sudo= if you are
-not the root user). The Rust installation will give you options to
-customize the installation; I used the default installation options.
+First, you will need to install the Rust package for your system. On Ubuntu, use
+the following commands (remember to use =sudo= if you are not the root user).
+The Rust installation will give you options to customize the installation; I
+used the default installation options.
#+begin_src sh
sudo apt update && sudo apt upgrade -y
@@ -54,8 +52,8 @@ cargo install agate
* Create Symlinks
-Once Cargo has finished installing all the required packages, symlink
-the executable to your $PATH.
+Once Cargo has finished installing all the required packages, create a symbolic
+link to the executable to your $PATH.
#+begin_src sh
sudo ln -s $HOME/.cargo/bin/agate /usr/local/bin/agate
@@ -63,8 +61,8 @@ sudo ln -s $HOME/.cargo/bin/agate /usr/local/bin/agate
* Using Agate's Built-In Installation Tool
-If you're running Ubuntu or Debian, use the Debian installation script
-found in Agate's GitHub repository, under the =tools/debian= folder.
+If you're running Ubuntu or Debian, use the Debian installation script found in
+Agate's GitHub repository, under the =tools/debian= folder.
#+begin_src sh
git clone https://github.com/mbrubeck/agate
@@ -74,11 +72,11 @@ sudo ./install.sh
* Configure the Gemini Service
-We have a little more to do, but since this script tries to immediately
-run the service, it will likely fail with an exit code. Let's add our
-finishing touches. Edit the following file and replace the hostname with
-your desired URL. You can also change the directory where content will
-be served.
+We have a little more to do, but since this script tries to immediately run the
+service, it will likely fail with an exit code. Let's add our finishing touches.
+Edit the following file and replace the hostname with your desired URL (uniform
+resource locator). You can also change the directory where content will be
+served.
#+begin_src sh
sudo nano /etc/systemd/system/gemini.service
@@ -97,8 +95,8 @@ WorkingDirectory=/var/gemini/
ExecStart=agate --hostname gemini.example.com --lang en
#+end_src
-Since we've altered the systemd configuration files, we have to reload
-the daemon. Let's do that, restart our service, and check its status.
+Since we've altered the systemd configuration files, we have to reload the
+daemon. Let's do that, restart our service, and check its status.
#+begin_src sh
sudo systemctl daemon-reload
@@ -108,8 +106,8 @@ sudo systemctl status gemini.service
* Fixing Systemd Errors
-If you're still getting errors, the installation process may not have
-properly enabled the gemini service. Fix it with the following commands.
+If you're still getting errors, the installation process may not have properly
+enabled the gemini service. Fix it with the following commands.
#+begin_src sh
sudo systemctl enable gemini.service
@@ -119,9 +117,9 @@ sudo systemctl status gemini.service
* Firewall Rules
-Great! Our server is now functional and running. The first consideration
-now is that you need to be able to access port 1965 on the server. If
-you have a firewall enabled, you'll need to open that port up.
+Great! Our server is now functional and running. The first consideration now is
+that you need to be able to access port 1965 on the server. If you have a
+firewall enabled, you'll need to open that port up.
#+begin_src sh
sudo ufw allow 1965
@@ -131,21 +129,18 @@ sudo ufw reload
* Creating Content
Let's create the Gemini capsule. Note that wherever you set the
-WorkingDirectory variable to earlier, Agate will expect you to put your
-Gemini capsule contents in a sub-folder called "content." So, I place my
-files in "/var/gmi/content." I'm going to create that folder now and put
-a file in there.
+=WorkingDirectory= variable to earlier, Agate will expect you to put your Gemini
+capsule contents in a sub-folder called =content=. So, I place my files in
+=/var/gmi/content=. I'm going to create that folder now and put a file in there.
#+begin_src sh
sudo mkdir /var/gemini/content
sudo nano /var/gemini/content/index.gmi
#+end_src
-You can put whatever you want in the "index.gmi" file, just make sure
-it's valid Gemtext.
+You can put whatever you want in the =index.gmi= file, just make sure it's valid
+Gemtext.
* The Results
-To view the results, you can use a Gemini browser, such as
-[[https://gmi.skyjake.fi/lagrange/][Lagrange]] or
-[[https://github.com/makeworld-the-better-one/amfora][amfora]].
+To view the results, you can use a Gemini browser, such as [[https://gmi.skyjake.fi/lagrange/][Lagrange]] or [[https://github.com/makeworld-the-better-one/amfora][amfora]].