1 files changed, 124 insertions, 0 deletions
diff --git a/blog/2023-06-30-self-hosting-voyager-lemmy-client.org b/blog/2023-06-30-self-hosting-voyager-lemmy-client.org
new file mode 100644
index 0000000..d5f9fc6
--- /dev/null
+++ b/blog/2023-06-30-self-hosting-voyager-lemmy-client.org
@@ -0,0 +1,124 @@
++++
+date = 2023-06-30
+title = "Self Hosting Voyager - A Lemmy Web Client"
+description = "A guide on how to self-host your own instance of Voyager, a mobile-first Lemmy web client."
++++
+
+## Installation Guide
+
+[Voyager](https://github.com/aeharding/voyager) is a mobile-first Lemmy web 
+client, based on iOS design standards. It follows very closely to Apollo's 
+design.
+
+This post is a guide showing how I was able to build and launch my own instance 
+of Voyager via Docker Compose.
+
+### Clone the Repository
+
+Start by cloning the repository and entering it:
+
+```sh
+git clone https://github.com/aeharding/voyager
+cd voyager
+```
+
+### Build the Image
+
+With this repository, you can build the image yourself without any further 
+configuration.
+When complete, it'll give you the image ID for you to run.
+
+```sh
+sudo docker build .
+# Successfully built 5f00723cb5be
+```
+
+With the image ID above, you can run the container and pass the requested port 
+`5314` through or use a custom port, if you wish.
+
+You can also set the `CUSTOM_LEMMY_SERVERS` environment variable if you want to 
+add to the default suggested login servers.
+This must be set with a comma separated list of suggested servers.
+The first instance in the list will be the default view for logged-out users.
+
+I will be using a `docker-compose.yml` file to run this container, instead of a 
+`docker run` command.
+
+```sh
+nano docker-compose.yml
+```
+
+```conf
+version: "2"
+services:
+  voyager:
+    image: 5f00723cb5be
+    restart: always
+    ports:
+      - "<custom_port>:5314"
+    environment:
+      - CUSTOM_LEMMY_SERVERS=lemmy.dbzer0.com,lemmy.world,lemmy.ml,beehaw.org
+```
+
+```sh
+sudo docker-compose up -d
+```
+
+The web app will now be available at the following address: 
+`<machine_ip>:<custom_port>`.
+If you are running it on your local device, try `localhost:<custom_port>`.
+
+### Reverse Proxy
+
+If you want to visit this app via an external URL or domain name, you'll need to 
+set up a reverse proxy.
+The example below uses Nginx as a reverse proxy.
+
+Simply create the configuration file, paste the contents below, save the file, 
+symlink the file, and restart Nginx.
+
+```sh
+sudo nano /etc/nginx/sites-available/voyager
+```
+
+```conf
+server {
+	if ($host ~ ^[^.]+\.example\.com$) {
+		return 301 https://$host$request_uri;
+	}
+
+	listen [::]:80;
+	listen 80;
+	server_name voyager.example.com;
+	return 404;
+}
+
+server {
+	listen [::]:443 ssl http2;
+	listen 443 ssl http2;
+	server_name voyager.example.com;
+	access_log  /var/log/nginx/voyager.access.log;
+	error_log   /var/log/nginx/voyager.error.log;
+
+	location / {
+		proxy_http_version 1.1;
+		proxy_pass http://localhost:5314;
+		proxy_set_header Host $host;
+	}
+
+	ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
+	ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
+	include /etc/letsencrypt/options-ssl-nginx.conf;
+	ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
+}
+```
+
+```sh
+sudo ln sudo ln -s /etc/nginx/sites-available/voyager /etc/nginx/sites-enabled/voyager
+sudo systemctl restart nginx.service
+```
+
+The site will now be available at the `server_name` you specified above!
+
+You can visit my instance at [voyager.0x4b1d.org](https://voyager.0x4b1d.org) 
+for an example.