diff options
| author | Christian Cleberg <[email protected]> | 2025-11-11 21:25:46 -0600 |
|---|---|---|
| committer | Christian Cleberg <[email protected]> | 2025-11-11 21:25:46 -0600 |
| commit | ce7749abd0114d836d116ecbeb001d0a3827be3b (patch) | |
| tree | fa74563f278197e81e8928aa322d132013b958d5 /content/blog/2021-04-17-gemini-server.org | |
| parent | af67e996dc93ade1acd4eed47d25da55c0c63b50 (diff) | |
| download | cleberg.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.org | 71 |
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]]. |
