w3kllc/mm-user-manager repository overview

⁠Mattermost User Manager

A self-hosted, password-protected web UI for managing Mattermost user profiles — built for administrators who need to edit user accounts without navigating the full Mattermost System Console.

⁠Features

• Edit username, display name, email, nickname, position, locale, and timezone
• Toggle email/push/desktop notifications per user
• Search users by username, email, or display name
• Secure session-based authentication (username + password)
• 30-minute inactivity auto-logout with warning toast
• Connects to any self-hosted Mattermost instance via Personal Access Token
• Fully self-contained — single container, no database

⁠Supported Platforms

⁠Quick Start

docker run -d \
  -p 8099:8099 \
  -e APP_USERNAME=admin \
  -e APP_PASSWORD=changeme \
  --name mm-user-manager \
  w3kllc/mm-user-manager:latest

Then open http://localhost:8099 and log in with your chosen credentials.

⁠Environment Variables

⁠Portainer / docker-compose

services:
  mm-user-manager:
    image: w3kllc/mm-user-manager:latest
    container_name: mm-user-manager
    ports:
      - "${HOST_PORT:-8099}:8099"
    environment:
      - APP_USERNAME=${APP_USERNAME}
      - APP_PASSWORD=${APP_PASSWORD}
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

⁠Connecting to Mattermost

After logging in, enter:

• Mattermost Server URL — e.g. https://mattermost.example.com
• Personal Access Token — generated in Mattermost under Account Settings → Security → Personal Access Tokens (requires the account to have the manage_others_bots or System Admin role)