How to Install Zoraxy on Your UGREEN NAS

by

How to Install Zoraxy on Your UGREEN NAS

Zoraxy is a lightweight, fast, and beginner-friendly reverse proxy written in Go, built for homelabs and self-hosters. It lets you easily expose web services, containers, and TCP/UDP traffic under custom domains with automatic Let’s Encrypt HTTPS, full HTTP/2 & WebSocket support, load balancing, flexible routing, and strong access controls (IP/country filtering, OAuth2, Basic Auth, Forward Auth). The clean web dashboard also includes real-time monitoring, traffic statistics, uptime checks, and handy built-in tools like mDNS/port scanners, traceroute, Wake-on-LAN, and a web-based SSH terminal. It runs as a single static binary on Linux, Windows, Raspberry Pi/ARM, NAS or Docker, with zero-downtime config changes and no complex files needed. Simple, powerful, and open-source. In this step by step guide I will show you how to install ZoraxyĀ on your UGREEN NAS using Docker and Portainer.

šŸ’”Note: This guide works perfectly with the latest Zoraxy v3.3.2 release.

āš ļøImportant note

This Zoraxy guide is specifically intended for more experienced users. If you are less experienced or a beginner, I recommend continuing to use my Nginx Proxy Manager guide, which is very easy and intuitive. Nginx Proxy Manager is simple to use, even for newcomers, while Zoraxy requires greater familiarity with advanced configurations. Therefore, use this guide only if you already have a good level of technical knowledge.

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

InstallĀ Portainer using my step by step guide. If you already have Portainer installed on your UGREEN NAS, skip this STEP. Attention: Make sure you have installed the latest Portainer version.

  • STEP 3

āš ļøMandatory: Make sure you have a domain name registered. Follow my How To Use Your Own Domain Name on Your UGREEN NAS guide from STEP 1 to STEP 9.

  • STEP 4

āš ļøMandatory: Stop the Nginx Proxy Manager container in Portainer or Dockhand. āš ļøNote: If you do not stop the Nginx Proxy Manager container, ports 80 and 443 will remain occupied and Zoraxy will not be able to start.

  • STEP 5

Go toĀ Files and open the docker folder. Inside the docker folder, create one new folder and name it zoraxy. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

Zoraxy UGREEN NAS Set up 1

  • STEP 6

Now create two new folders inside the zoraxy folder that you have previously created at STEP 5 and name them config and plugin. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters

Zoraxy UGREEN NAS Set up 2

  • STEP 7

āš ļøMandatory: Add Read & Write Permissions to the Docker Folder.

  • STEP 8

In the Name field type in zoraxy. Follow the instructions in the image below.

Note: Copy Paste the code below in the Portainer Stacks Web editor.

services:
  zoraxy:
    image: zoraxydocker/zoraxy:latest
    container_name: Zoraxy
    ports:
      - 80:80 
      - 443:443
      - 8666:8000
    volumes:
      - /volume1/docker/zoraxy/config:/opt/zoraxy/config:rw
      - /volume1/docker/zoraxy/plugin:/opt/zoraxy/plugin:rw
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
       TZ: Europe/Bucharest
       FASTGEOIP: true #Change to false instead of true if your RAM memory is less than <4GB.
    restart: on-failure:5

Note: Before you paste the code above in the Web editor area below, change the value for TZ.Ā (Select your current Time Zone from this list.)

Zoraxy UGREEN NAS Set up 3

  • STEP 9

Scroll down on the page until you see a button namedĀ Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.

Zoraxy UGREEN NAS Set up 4

  • STEP 10

If everything goes right, you will see the following message at the top right of your screen: ā€œSuccess Stack successfully deployedā€œ.

Portainer Success Stack NAS

  • STEP 11

šŸŸ¢Please Support My work by Making a Donation. Almost 99,9% of the people that install something using my guidesĀ forget to support my work, or justĀ ignoreĀ STEP 1. Iā€™ve been very honest about this aspect of my work since the beginning: I donā€™t run any ADS, I donā€™t require subscriptions, paid or otherwise, I donā€™t collect IPs, emails, and I donā€™t have any referral links from Amazon or other merchants. I also donā€™t have any POP-UPs or COOKIES. I have repeatedly been told over the years how much I have contributed to the community. Itā€™s something I love doing and have been honest about my passion since the beginning. But I also Need The Community to Support me Back to be able to continue doing this work.

  • STEP 12

The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser and type inĀ http://ugreen-ip-address:8666 Create your Administrator user. Type in your own Username and Password. Click Confirm. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 5

  • STEP 13

Type in your own Username and Password that you have previously added at STEP 12. Click Login. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 6

  • STEP 14

At the top right of the page, switch the theme to Dark. On the left sidebar, under Security, click TLS / SSL certificates. In the ACME Email filed, type in your own email address, then click Save Settings. āš ļøNote: Your Email is mandatory to retrieve the free Let’s Encrypt Certificate for your domains/subdomains. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 7

  • STEP 15

On the left sidebar, click Create Proxy Rules. Type in your own domain name without https:// at the beginning. You should already have your domain name set up as per the instructions at STEP 3. In the Target IP area, type in your own NAS IP followed by :9999 (šŸ–¼ļøCheck out the example screenshot). Select Block Common Exploits. You can add different Access Rules. For example, block specific countries from accessing your domain name or an extra Basic Authorization. Add an extra Basic Authorization by adding a Username and Password. Click Add Credentials. Click Create Endpoint. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 9

  • STEP 16

A new pop up window will open. Click Confirm to get your free Let’s Encrypt certificate. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 10

  • STEP 17

After the certificate is created, on the left sidebar, click HTTP Proxy. Click on your host/domain name that has been created. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 11

  • STEP 18

In your browser, type in your own domain name. You will notice that you will be asked for a Basic Authorization (Username and Password). This happens because you have added the option for Basich Auth at STEP 15. Type in your own Username and Password that you have previously added at STEP 15, then click Sign in. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 12

  • STEP 19

You can now access your UGREEN NAS via HTTPS / SSL Certificate and your own Domain Name from anywhere.

Zoraxy UGREEN NAS Set up 13

  • STEP 20

Now, I will show you how to add a new hostname to a specific Docker container. I will use Homarr as an example.
InstallĀ Homarr using my step by step guide. If you already have Homarr installed on your UGREEN NAS, skip this STEP. āš ļøAttention: Mandatory STEP.

āš ļøMandatory: Follow my How To Use Your Own Domain Name on Your UGREEN NAS guide from STEP 18 to STEP 20.

  • STEP 21

On the left sidebar, click Create Proxy Rules. Type in your own subdomain name without https:// at the beginning. You should already have your sub domain name set up as per the instructions at STEP 20. In my case, it’s homarr.beemarius.com – In the Target IP area, type in your own NAS IP followed by :7575 (āš ļø7575 is the homarr localhost port). Select Block Common Exploits. You can add different Access Rules. For example, block specific countries from accessing your domain name or an extra Basic Authorization. Add an extra Basic Authorization by adding a Username and Password. Click Add Credentials. Click Create Endpoint. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 14

  • STEP 22

A new pop up window will open. Click Confirm to get your free Let’s Encrypt certificate. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 15

  • STEP 23

After the certificate is created, on the left sidebar, click HTTP Proxy. Click on your host/domain/subdomain name that has been created. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 16

  • STEP 24

In your browser, type in your own subdomain/domain name. You will notice that you will be asked for a Basic Authorization (Username and Password). This happens because you have added the option for Basich Auth at STEP 21. Type in your own Username and Password that you have previously added at STEP 21, then click Sign in. Follow the instructions in the image below.

Zoraxy UGREEN NAS Set up 17

  • STEP 25

You can now access your Homarr Docker container via HTTPS / SSL Certificate and your OWN Domain / Subdomain Name from anywhere.

Zoraxy UGREEN NAS Set up 18

  • STEP 26

On the left sidebar in Zoraxy, click Statistical Analysis to access the full stats of your domain name.

Zoraxy UGREEN NAS Set up 19

Enjoy Zoraxy!

šŸ†˜TROUBLESHOOTING

šŸ†™Note/Update/Container: How to Update Your Docker Containers on UGREEN NAS Using Portainer.
šŸ³Note: How to Create Docker Shortcuts on Desktop.
šŸ†•Note: How to Update Portainer to the latest version.
šŸ†•Note: How to Clean Docker.

This post was updated on Sunday / March 1st, 2026 at 11:42 PM

No sponsors, no corporations, no ads, no subscriptions, no membership tiers, no referral links, no pop-ups, no cookies, no tracking code. Just pure guides for the community from Marius.