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

**URL:** <https://forum.hhf.technology/t/guide-for-setting-up-the-nginx-ui-components-in-unraid-2024/434>\
**Category:** Self-hosted Applications\
**Tags:** unraid, nginx-ui\
**Created:** [December 5, 2024, 4:23pm UTC](https://forum.hhf.technology/t/guide-for-setting-up-the-nginx-ui-components-in-unraid-2024/434 "2024-12-05T16:23:15Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![hhf.technoloy](https://forum.hhf.technology/user_avatar/forum.hhf.technology/hhf.technoloy/32/68_2.png) [@hhf.technoloy](https://forum.hhf.technology/u/hhf.technoloy)\
**Post date:** [December 5, 2024, 4:23pm UTC](https://forum.hhf.technology/t/guide-for-setting-up-the-nginx-ui-components-in-unraid-2024/434/1 "2024-12-05T16:23:15Z")

</div>

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

1. **Installation Setup**

2. **Path Configuration** :  
You’ll need to verify/create these directories:

```auto
/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:

4. **Directory Structure** :

```auto
/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:

```bash
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:

```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`

[unraid\_app\_templates/nginx-ui at main - hhf/unraid\_app\_templates - HHF Technology Repository: A painless, self-hosted Git service](https://git.hhf.technology/hhf/unraid_app_templates/src/branch/main/nginx-ui)