Guide for setting up the nginx-ui components in unRAID. 2024

Guide for setting up the nginx-ui components in unRAID.

  1. Installation Setup

    • Open your unRAID dashboard
    • Go to the “Apps” tab
    • Click “Add Container” button
    • Copy and paste the template we created into the template field
  2. Path Configuration:
    You’ll need to verify/create these directories:

/mnt/user/appdata/nginx     # For nginx configurations
/mnt/user/appdata/nginx-ui  # For nginx-ui specific data
/var/www                    # For web files
  1. Port Configuration:
  • Port 8080: Web interface access
    • Can be changed if this port conflicts with other services
    • Default mapping: 8080 → 80 (internal)
  • Port 8443: SSL access
    • Can be changed if this port conflicts
    • Default mapping: 8443 → 443 (internal)
  1. Environment Variables:
  • TZ=Asia/Singapore
    • Change this to your timezone if needed
    • Common values: America/New_York, Europe/London, etc.
  1. Post-Installation Steps:
    After installing:

  2. Access the web interface at: http://[your-unraid-ip]:8080

  3. Initial setup will guide you through:

    • Creating an admin account
    • Basic nginx configuration
    • SSL setup (if needed)
  4. Directory Structure:

/mnt/user/appdata/nginx/
├── nginx.conf         # Main nginx configuration
├── conf.d/           # Site configurations
└── ssl/              # SSL certificates

/mnt/user/appdata/nginx-ui/
├── config/           # nginx-ui configurations
└── database/         # nginx-ui database

/var/www/            # Web root directory
└── html/            # Default web files
  1. Permissions:
  • All directories are set to read/write (rw)
  • The container runs unprivileged
  • Make sure the directories are owned by the correct user:
    chown -R 99:100 /mnt/user/appdata/nginx
    chown -R 99:100 /mnt/user/appdata/nginx-ui
    
  1. Backup Considerations:
    Important directories to backup:
  • /mnt/user/appdata/nginx
  • /mnt/user/appdata/nginx-ui
  1. Security Recommendations:
  • Change default ports if exposed to internet
  • Use SSL for external access
  • Set up strong admin passwords
  • Consider using unRAID’s built-in SSL reverse proxy
  1. Troubleshooting Tips:
  • Check container logs in unRAID dashboard
  • Verify port availability with:
    netstat -tuln | grep '8080\|8443'
    
  • Ensure all paths exist and have correct permissions
  • Check nginx-ui logs at /mnt/user/appdata/nginx-ui/logs

unraid_app_templates/nginx-ui at main - hhf/unraid_app_templates - HHF Technology Repository: A painless, self-hosted Git service

1 Like