OCCを使用してNextcloud管理者パスワードをリセットする方法

管理者アカウントで Nextcloud にログインできなくなった場合は、サーバー側のoccコマンドを使用して、Web インターフェイスを使用せずにそのアカウントのパスワードをリセットできます。occは Nextcloud の管理用コマンドライン インターフェイスです。リセットによって変更されるのは Nextcloud アカウントのパスワードであり、Linux ログイン、データベース パスワード、またはホスティング コントロール パネルのパスワードは変更されません。

このチュートリアルでは、2026年10月6日現在公開されている最新のNextcloud 35管理マニュアルを使用しています。基本的なコマンドは多くのリリースで安定していますが、インストールパス、PHPコマンド、サービスアカウント、コンテナワークフローはバージョンによって異なります。サンプル値を使用する際は、ご自身のインスタンスのインストール方法を確認してからにしてください。

リセットを実行する前に必要なもの

• NextcloudのPHPアプリケーションを実行しているサーバーまたはコンテナへのシェルアクセス。
• Nextcloudのインストール先となるファイルシステムパス。つまり、ファイルが含まれているディレクトリですocc。
• パスワードを変更する必要のある正確な Nextcloud アカウント ID。アカウント ID は であってはなりませんadmin。
• ウェブサーバーまたはPHPランタイムが使用するオペレーティングシステムのアカウント。DebianおよびUbuntuでは、多くの場合 です。www-data他のシステムでは、別のアカウントが使用される場合があります。
• パスワードマネージャーに保存された、新しく固有のパスワード。

occファイルの所有権とアクセス権限を一定に保つため、HTTPユーザー（Webアプリケーションを実行するオペレーティングシステムのアカウント）として実行してください。Nextcloudのマニュアルにもこの要件が記載されています。sudo権限があるからといって、デフォルトでroot権限でコマンドを実行しないでください。

ステップ1：適切なインストールとアカウントを見つける

SSH経由で接続するか、ホスティング環境が提供するシェルを開きます。Nextcloudのインストールディレクトリに移動します。一般的なソースインストールパスは です/var/www/nextcloudが、パッケージ、アプライアンス、コンテナ、ホスト型サービスでは異なるパスが使用される場合があります。

cd /var/www/nextcloud
ls -l occ

2番目のコマンドを実行するとoccファイルが表示されるはずです。表示されない場合は、推測したパスを試すのではなく、実行を中止して実際のアプリケーションディレクトリを特定してください。アカウント名が異なる場合は、admin後続のコマンドでそのNextcloudユーザーIDに置き換えてください。ユーザーIDは、表示名やメールアドレスとは必ずしも一致しません。

ステップ2：対話型パスワードリセットを実行する

ウェブサーバーがとして実行される一般的な Debian または Ubuntu ソースインストールの場合www-data、Nextcloud ディレクトリから次のコマンドを実行します。

sudo -E -u www-data php occ user:resetpassword admin

www-dataサーバーが別の HTTP ユーザーを使用している場合は、<username> を置き換え、admin確認済みのアカウント ID に置き換えてください。インストール ディレクトリにいない場合は、フル パスを使用してください。

sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword admin

Nextcloudは新しいパスワードの入力を求め、確認を求めます。通常、入力中はパスワード文字は表示されません。これは正常な動作です。両方のプロンプトで同じパスワードを入力してください。成功メッセージが表示されれば、Nextcloudがパスワードのリセットを受け入れたことが確認できます。

ステップ3：自動化のためだけに環境変数を使用する

Nextcloudは--password-from-envスクリプトによる操作もサポートしています。パスワードはOC_PASS環境変数から読み取られます。実際のパスワードをコマンドライン、シェル履歴、ソース管理にコミットされたスクリプト、または共有ターミナルトランスクリプトに直接入力することは避けてください。

一度限りのシェルセッションの場合は、シークレットをエコーせずに入力し、エクスポートし、ドキュメントに記載されているコマンドを実行してから、クリアすることができます。

read -s OC_PASS
export OC_PASS
sudo -E -u www-data php occ user:resetpassword --password-from-env admin
unset OC_PASS

その後read -s、新しいパスワードを入力して Enter キーを押します。入力欄は非表示のままです。この-Eオプションは sudo に環境を保持するように指示しますが、ローカルの sudo ポリシーによってその動作が制限される場合があります。コマンドが がOC_PASS見つからないか空であると報告した場合は、代わりに対話型リセットを使用するか、プラットフォームのシークレット管理手順に従ってください。スクリプトを動作させるためだけに sudo の安全対策を無効にしないでください。

ステップ4：アカウントがサインインできることを確認する

プライベートブラウザウィンドウで通常のNextcloud URLを開くか、現在のセッションからログアウトしてから、同じアカウントIDと新しいパスワードでログインしてください。ログインが成功すれば、CLIコマンドが実行されただけでなく、Webアプリケーションで認証情報が正しく機能していることが確認できます。組織で2要素認証を使用している場合は、通常の認証も完了してください。

よくある問題とその対処法

• Could not open input file: occまたはファイルが見つからないエラー：おそらくディレクトリが間違っているか、パスが間違っています。インストールされているoccファイルを見つけて、そこでコマンドを再実行してください。
• 権限または所有権のエラー：お使いのディストリビューションのWebサーバー/PHPアカウントを確認し、そのアカウントでコマンドを実行してください。一時的な解決策として所有権を再帰的に変更しないでください。より広範囲なアクセス問題を引き起こす可能性があります。
• 「ユーザーが存在しません」または同様のアカウントエラーが発生した場合：アカウントIDを、大文字・小文字の区別を含めて確認してください。メールアドレスが実際のアカウントIDでない限り、メールアドレスを代用しないでください。
• phpPHP が不足しているか、間違った PHP バージョンが選択されています。Nextcloudのインストール環境とホスティング プラットフォームでサポートされている PHP CLI バイナリを使用してください。サーバーには複数の PHP インストールが存在する可能性があるため、デフォルトのコマンドが Web ランタイムと一致するとは限りません。
• サーバーは、Docker、Nextcloud AIO、Snap、またはアプライアンスで動作します。アプリケーション環境で実行しocc、そのデプロイメントの公式コマンド手順に従ってください。ホストパス、コンテナ名、およびランタイムユーザーは異なるため、ソースインストールからコピーしたホストレベルのコマンドは、誤ったファイルシステムを対象とする可能性があります。
• アカウントはLDAPまたはActive Directoryによって管理されています。これらのシステムはアカウント認証情報の認証機関となることができます。Nextcloudのローカルパスワードリセットでは、外部で管理されているパスワードは更新されない場合があります。ディレクトリ管理者のリセット手順に従い、IDプロバイダーの設定を確認してください。
• シェルへのアクセス権がありません。アカウントに有効なメールアドレスがNextcloudに保存されている場合は、サインインページのパスワードリセットリンクをお試しください。または、別のNextcloud管理者またはホスティングプロバイダにパスワードのリセットを依頼してください。

回復後に避けるべきこと

パスワードハッシュを置き換えるために、Nextcloudデータベースを直接編集しないでください。Nextcloudユーザーのパスワードをリセットする目的で、オペレーティングシステムのパスワードを変更しないでください。新しいパスワードは秘密にしておき、シェル環境から一時的な秘密情報をすべて削除し、パスワードマネージャーに保存してください。古い認証情報が漏洩した疑いがある場合は、組織の通常のセキュリティプロセスに従ってアクセス状況を確認してください。

公式資料

Nextcloud では、復旧オプションと管理者パスワード紛失時の手順を「紛失した管理者パスワードのリセット」で説明しています。サポートされているコマンド、パスワードプロンプト、環境変数オプションについては、「ユーザーおよびグループコマンド」と「occ コマンドの使用」で説明しています。