1 files changed, 119 insertions, 0 deletions
diff --git a/blog/self-hosting-voyager/index.org b/blog/self-hosting-voyager/index.org
new file mode 100644
index 0000000..281cb38
--- /dev/null
+++ b/blog/self-hosting-voyager/index.org
@@ -0,0 +1,119 @@
+#+title: Self-Hosting Voyager - A Lemmy Web Client
+#+date: 2023-06-30
+#+description: A guide to self-hosting the Voyager application on your own server.
+#+filetags: :selfhosting:
+
+* Installation Guide
+[[https://github.com/aeharding/voyager][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:
+
+#+begin_src sh
+git clone https://github.com/aeharding/voyager
+cd voyager
+#+end_src
+
+** 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.
+
+#+begin_src sh
+sudo docker build .
+# Successfully built 5f00723cb5be
+#+end_src
+
+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.
+
+#+begin_src sh
+nano docker-compose.yml
+#+end_src
+
+#+begin_src 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
+#+end_src
+
+#+begin_src sh
+sudo docker-compose up -d
+#+end_src
+
+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.
+
+#+begin_src sh
+sudo nano /etc/nginx/sites-available/voyager
+#+end_src
+
+#+begin_src 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;
+}
+#+end_src
+
+#+begin_src sh
+sudo ln sudo ln -s /etc/nginx/sites-available/voyager /etc/nginx/sites-enabled/voyager
+sudo systemctl restart nginx.service
+#+end_src
+
+The site will now be available at the =server_name= you specified above!
+
+You can visit my instance at
+[[https://voyager.cleberg.net][voyager.cleberg.net]] for an example.