Standard Setup Guide for Self-Hosted

Introduction

This guide is for setting up Hudu with a free LetsEncrypt SSL certificate that will renew automatically for you. If you are looking to use a custom SSL certificate, you may want to read this article for alternative options: Getting Started with Hudu Self-Hosted.

Prerequisites

In order to self-host Hudu, you will need:

• Server with at least 4GB memory and at least 1 CPU (as long as there is no contention), with Ubuntu (18.04, 20.04, or 22.04) as the OS.
• SMTP server for sending outgoing mail.
• An A record pointed to the Public IP of the instance. Usually something like docs.mywebsite.com or hudu.mywebsite.com
• Ports 443 and 80 opened externally (required for LetsEncrypt).

Guides

Video Instructions

Would you prefer a video walk-through of the setup? Here is a video from one of our great partners.

Instructions

• Test that ports 443 and 80 are opened for your publicly accessible A record.
  • Enter your URL to this tool. If both ports aren't showing as open, then you will need to fix that first.
• SSH into the server you are wishing to host Hudu on.
• Install Docker CE on the server. Setup instructions can be found here. Do not use SNAP to install Docker - this will cause issues later on.
• Create a blank directory named hudu2 on the home directory. On Ubuntu, you can do this by typing:

  mkdir ~/hudu2

  Move into the directory. On Ubuntu:

  cd ~/hudu2

• Place a file named docker-compose.yml in the directory. The contents can be found here.
• Place a file named .env in the directory. The contents need to be generated with our config generator: here.

• When both files are residing within the directory, run the command: sudo docker compose up -d to start your Hudu instance.
• Wait for the command to execute. You will know it is done when you can visit your domain and see a page referring to SWAG (the name of the SSL Cert Tool we use).
• You will now need to set up an SSL certificate for your instance. Type sudo docker compose down to shut down your instance.
• Navigate to /var/www/hudu2/config/nginx/site-confs/. With Ubuntu, you can do this by typing: cd /var/www/hudu2/config/nginx/site-confs/
• Edit the file named default.conf and replace ALL of the contents with this file named default: here.
• Navigate back to the hudu2 folder. On Ubuntu: cd ~/hudu2
• Start the instance again: sudo docker compose up -d
• Your Hudu should now be up and running! Visit your domain to confirm. If you see a Hudu sign-up screen, it's successful. Reach out to support for a license key.
• If you don't see this screen, contact support, and please provide logs: sudo docker compose logs
  • Please paste these into something like Pastebin.com