Skip to content

BookJJun-IJ/UnraidTest

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Yundera Unraid Templates

Official Unraid Community Applications templates for Yundera's open-source infrastructure projects.

🌐 About Yundera

Yundera develops open-source infrastructure for self-hosted applications:

📦 Available Templates

NSL Router

Free HTTPS subdomains for your Unraid server without port forwarding.

What you get:

  • Free subdomain: username.nsl.sh
  • Automatic HTTPS for all apps
  • Clean URLs: jellyfin.username.nsl.sh, nextcloud.username.nsl.sh
  • No port forwarding needed
  • WireGuard VPN secured

Use cases:

  • Access your media server from anywhere
  • Share services with friends/family
  • Remote access without VPN client
  • Professional URLs for self-hosted services

Template: nsl-router.xml


🚀 Installation

Method 1: Community Applications (Recommended)

  1. Open Unraid WebGUI
  2. Go to Apps tab
  3. Search for "NSL Router"
  4. Click Install
  5. Configure your subdomain name
  6. Done!

Method 2: Manual Template Repository

If templates aren't in Community Applications yet:

  1. Go to AppsSettings
  2. Under "Template repositories", add:
    https://github.com/Yundera/mesh-router
    
  3. Click Save
  4. Reload Apps tab
  5. Search for "NSL Router"

📖 NSL Router Setup Guide

Step 1: Install NSL Router

  1. Install from Community Applications
  2. Set your Subdomain Name (e.g., mynas)
  3. Your domain will be: mynas.nsl.sh
  4. Start the container

Step 2: Configure Your Apps

Make sure your apps:

  • Are on the same Docker network as NSL Router (default: bridge)
  • Expose port 80 internally
  • Have a container name (this becomes the subdomain)

Step 3: Access Your Apps

Your apps are automatically available at:

https://[container-name].[your-subdomain].nsl.sh

Examples:

  • Jellyfin container → https://jellyfin.mynas.nsl.sh
  • Nextcloud container → https://nextcloud.mynas.nsl.sh
  • Plex container → https://plex.mynas.nsl.sh

Optional: Set Default App

Set DEFAULT_HOST to redirect your main domain to a specific app:

  • Set to jellyfinhttps://mynas.nsl.sh goes to Jellyfin
  • Leave empty → No default redirect

⚙️ Configuration Reference

Required Settings

Setting Description Example
Subdomain Name Your unique subdomain mynas
Provider URL NSL provider (default: https://nsl.sh) https://nsl.sh
WireGuard Port VPN port (must be 51820/udp) 51820

Optional Settings

Setting Description Default
Default App Main domain redirect target (empty)
Docker Network Network where apps run bridge
Config Directory Config storage path /mnt/user/appdata/nsl-router

Advanced Settings

Setting Description Default
PUID User ID for file permissions 99
PGID Group ID for file permissions 100

🔧 Troubleshooting

App not accessible

Check 1: Same Docker network?

docker inspect nsl-router | grep NetworkMode
docker inspect [your-app] | grep NetworkMode

They should match (usually bridge).

Check 2: App exposes port 80?

docker inspect [your-app] | grep ExposedPorts

Should show "80/tcp": {}.

Check 3: NSL Router running?

docker logs nsl-router

Look for "Successfully registered with provider".

Subdomain name already taken

Choose a different name - subdomain names are first-come-first-served.

WireGuard connection issues

Ensure port 51820/udp is not blocked by firewall.


🤝 Support


📄 License

Templates are released under MIT License.

Individual projects may have their own licenses:


💝 Support Development

If you find our projects useful:

  • ⭐ Star our repositories
  • 💰 Sponsor on GitHub
  • 📢 Share with others
  • 🐛 Report bugs
  • 🔧 Contribute code

🔗 Links


Made with ❤️ by Yundera Team

About

Testing before Uploading to unraid

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors