80 lines
No EOL
2.4 KiB
Markdown
80 lines
No EOL
2.4 KiB
Markdown
## 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
|
|
```
|
|
|
|
3. **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)
|
|
|
|
4. **Environment Variables**:
|
|
- `TZ=Asia/Singapore`
|
|
- Change this to your timezone if needed
|
|
- Common values: `America/New_York`, `Europe/London`, etc.
|
|
|
|
5. **Post-Installation Steps**:
|
|
After installing:
|
|
1. Access the web interface at: `http://[your-unraid-ip]:8080`
|
|
2. Initial setup will guide you through:
|
|
- Creating an admin account
|
|
- Basic nginx configuration
|
|
- SSL setup (if needed)
|
|
|
|
6. **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
|
|
```
|
|
|
|
7. **Permissions**:
|
|
- All directories are set to read/write (rw)
|
|
- The container runs unprivileged
|
|
- Make sure the directories are owned by the correct user:
|
|
```bash
|
|
chown -R 99:100 /mnt/user/appdata/nginx
|
|
chown -R 99:100 /mnt/user/appdata/nginx-ui
|
|
```
|
|
|
|
8. **Backup Considerations**:
|
|
Important directories to backup:
|
|
- `/mnt/user/appdata/nginx`
|
|
- `/mnt/user/appdata/nginx-ui`
|
|
|
|
9. **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
|
|
|
|
10. **Troubleshooting Tips**:
|
|
- Check container logs in unRAID dashboard
|
|
- Verify port availability with:
|
|
```bash
|
|
netstat -tuln | grep '8080\|8443'
|
|
```
|
|
- Ensure all paths exist and have correct permissions
|
|
- Check nginx-ui logs at `/mnt/user/appdata/nginx-ui/logs` |