# Unraid SMB Password Portal

Unraid SMB Password Portal is a self-hosted network services app. Self-service web portal for Unraid servers that lets non-admin users change their own Samba/Server Message Block (SMB) share passwords without access to the Unraid web UI. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2368/unraid-smb-password-portal

## Description

Self-service web portal for Unraid servers that lets non-admin users change their own Samba/Server Message Block (SMB) share passwords without access to the Unraid web UI. Users enter their SMB username, current SMB password, and new SMB password (twice); the small Flask-based container uses the smbpasswd client to talk to the host's Samba service, reads SMB users from /boot/config/smbpasswd, and excludes root by default. It does not expose plaintext passwords, requires no Docker socket access or Unraid root credentials, auto-generates a persistent Flask secret key on first start, and is intended for LAN, VPN, Tailscale, WireGuard, or reverse-proxy-protected deployments.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

48/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 23 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/bmmbmm01/unraid-smb-password-portal
- Unraid: https://ca.unraid.net/apps/unraid-smb-password-portal-0x65rsf1etiern?q=unraid-smb-password-portal

## Common questions

### Can users reset a forgotten SMB password through the portal?

No. A user must know their current SMB password, and the tool only lets them change their own password. It does not perform admin password resets or create new Samba users.

### Is it safe to expose the portal to the public internet?

Do not expose the container directly to the public internet. Use LAN-only access, Tailscale or WireGuard, or a reverse proxy with HTTPS and access restrictions.

### Does the container require Unraid root credentials or the Docker socket?

No. It does not require Docker socket access or Unraid root credentials. It uses the smbpasswd client to talk to the host Samba service.

### Is host networking required on Unraid?

Host networking is recommended because the container can talk to the host Samba service at 127.0.0.1. Bridge networking can also be used, but host networking is preferred.

---
Source: Our Local Host (https://ourlocalhost.com/app/2368/unraid-smb-password-portal), the self-hosted and open-source app directory.
