Guide for setting up the nginx-ui components in unRAID.
-
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
-
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
- 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)
- Environment Variables:
TZ=Asia/Singapore
- Change this to your timezone if needed
- Common values:
America/New_York
,Europe/London
, etc.
-
Post-Installation Steps:
After installing: -
Access the web interface at:
http://[your-unraid-ip]:8080
-
Initial setup will guide you through:
- Creating an admin account
- Basic nginx configuration
- SSL setup (if needed)
-
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
- 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
- Backup Considerations:
Important directories to backup:
/mnt/user/appdata/nginx
/mnt/user/appdata/nginx-ui
- 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
- 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