こんにちは！
今回は Mattermostの管理者が特定ユーザーのユーザー名（例：@john_doe → @john）を変更する方法について解説します。

目的

Mattermostの管理者が、ユーザーに代わってユーザー名を変更したいときに使える手順です。
対象は自社運用しているMattermostサーバーで、mmctl（CLIツール）を使った方法になります。

前提条件

mmctlがある以下のディレクトリに移動します。

cd /opt/mattermost/bin

まずは Mattermost サーバー上にログインし、mmctl をローカルモードで使用して対象ユーザーを検索します：

sudo -u mattermost ./mmctl --local user search john_doe

実行例：

id: 2fg4xjjzof88jj4qa5yo3je7ow
username: john_doe
email: johndoe@example.com

上記で取得したユーザーIDを使って、以下のコマンドでユーザー名を変更します：

sudo -u mattermost ./mmctl --local user username 2fg4xjjzof88jj4qa5yo3je7ow john

成功すると：

User john updated successfully

Mattermostサーバーと同じホスト上で mmctl を使う場合に限定して、認証なしで直接操作できるモードです。

もし次のようなエラーが出たら：

Error: failed to create client: socket file "/var/tmp/mattermost_local.socket" doesn't exist

以下の2つを確認してください：

さらに、次のエラーが出た場合：

Error: failed to create client: owner of the file must be the same user running mmctl

これは mmctl を実行しているユーザーが mattermost と違うためです。
その場合は以下のように実行しましょう：

sudo -u mattermost ./mmctl --local ...

変更後は以下のコマンドで正しく変更されているか確認できます：

sudo -u mattermost ./mmctl --local user search john

操作	コマンド例
ユーザー検索	`mmctl --local user search <旧ユーザー名>`
ユーザー名変更	`mmctl --local user username <user-id> <新ユーザー名>`

MattermostではGUIからはユーザー名を変更できない場合もあるため、CLI操作を覚えておくと非常に便利です。
チーム内の命名ルールの統一やユーザー管理にも役立ちます。

質問やトラブルがあればぜひコメントください！