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

NextcloudのWebインターフェースにアクセスできなくなった場合でも、サーバー管理者はローカルアカウントのパスワードを変更できます。サーバーシェルにアクセスできる場合は、occ user:resetpasswordWebサーバーユーザーとしてNextcloudの組み込みコマンドを実行し、同じアカウント名と新しいパスワードでログインしてください。このコマンドは管理者アカウントだけでなく、一般ユーザーにも有効です。「admin」はユーザー名の例です。

以下のコマンドは、2026年10月10日に確認されたNextcloud 35管理マニュアルに基づいています。例に挙げたインストールパス、HTTPユーザー、PHP実行ファイル、ユーザー名を、ご使用のサーバーで使用されている値に置き換えてください。

パスワードを対話的にリセットする

1. Nextcloudのインストール場所とWebサーバーアカウントを見つける

シェルを使用でき、権限昇格が可能なアカウントでホストに接続します。occスクリプトを含むディレクトリを探します。一般的なUbuntuまたはDebianのパスは ですが/var/www/nextcloud、パッケージ、コンテナ、またはホスト型のインストールでは別の場所を使用する場合があります。ファイルの所有権が維持されるように、コマンドはNextcloudのインストールコンテキストでHTTPユーザーとして実行する必要があります。

Debian または Ubuntu では、そのユーザーは通常 ですwww-data。Nextcloud のドキュメントapacheは、Fedora または CentOS、httpArch、およびwwwrunopenSUSE 用です。ログインに使用する Linux アカウントではなく、実際の Web サーバー アカウントを使用してください。

2. OCCパスワードリセットコマンドを実行します。

このコマンドは、一般的な Debian または Ubuntu インストール環境で使用します。ユーザー名が正しくない場合は、適切なユーザー名に置き換えてくださいadmin。

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

Nextcloudは新しいパスワードの入力を求め、再度入力するよう促します。パスワードはシェルコマンドには含まれないため、シェル履歴に残ることはありません。コマンドがパスワードのリセットに成功したと報告したら、そのユーザー名と新しいパスワードを使用してWebログインを試してください。ユーザー名を置き換える際は、山括弧で囲まないでください。

公式ドキュメントにも記載されていますsudo -E -u www-data。この-Eオプションは環境変数を保持します。インストールで特定の環境設定が必要な場合を除き、通常の対話型リセットには必要ありません。Weboccサーバー用に構成されたPHP CLIバージョンで実行します。デフォルトのphp実行可能ファイルに互換性がない場合は、対応するPHPバイナリを明示的に呼び出します。

どのアカウントをリセットすればよいかわからない場合は

ログイン名はアカウントの Nextcloud ユーザー名であり、表示名やメールアドレスとは必ずしも一致しません。別の管理者アカウントをお持ちの場合は、ユーザーページを使用して該当するログイン名を確認してください。コマンドラインから、管理者は次のようにアカウントを一覧表示できます。

sudo -u www-data php /var/www/nextcloud/occ user:list

www-data必要に応じて、OCC パスを置き換えてください。出力には多数のユーザーアカウントが含まれる可能性があるため、個人情報が含まれている場合は公開しないでください。大規模なインストールの場合、このコマンドは制限やオフセットなどのオプションをサポートしています。occ help user:listお使いのバージョンで使用可能な構文については、現在の出力を確認してください。

もし他のNextcloud管理者にアクセスできる場合は、ユーザー設定でパスワードのリセットを依頼するのがより簡単な方法です。ログインページのリセットリンクは、以前に個人ページに有効なメールアドレスが保存されていて、サーバーがメールを送信できる場合にのみ使用できます。どちらの方法も利用できない場合で、シェルアクセスが可能な場合は、OCCが役立ちます。

一般的なコマンドラインの問題に対処する

「入力ファイルを開けませんでした」または「occが見つかりません」

コマンドが間違ったインストールディレクトリを指しています。パスを実際のoccスクリプトのパスに変更してください。インストールディレクトリに移動して、より短い形式のコマンドを実行することもできますsudo -u www-data php occ user:resetpassword admin。同じサーバー上の別の Nextcloud コピーから、同じ名前のスクリプトを実行しないでください。

権限、キャッシュ、またはPHPエラー

インストール時に想定されていたHTTPアカウントとPHP CLIバージョンを使用していることを確認してください。NextcloudのOCCドキュメントには、PHPコマンドラインモードではAPCuがデフォルトで無効になっていると記載されています。OCCがAPCuが利用できないと報告する場合は、apc.enable_cli正しいCLI構成で有効にするか、ドキュメントに記載されている--define apc.enable_cli=1呼び出し方法に従ってください。CLI固有のエラーに対処するためだけに、Web PHPの設定をむやみに変更しないでください。

このアカウントは外部のIDプロバイダーを使用しています

一部のインストールでは、LDAP、SAML、またはその他の外部IDプロバイダーを介してアカウントを認証します。その場合、プロバイダーがパスワードの管理権限を持つ可能性があり、Nextcloudのローカルアカウントデータに対してOCCリセットを実行しても、サインイン時に使用された認証情報が変更されない場合があります。OCCを使用する前に、IDプロバイダーが承認したプロセスでパスワードをリセットするか、構成済みのバックエンドがパスワード変更をサポートしていることを確認してください。このコマンドはNextcloudアカウントのパスワード用であり、IDプロバイダー自身の認証情報をリセットするものではありません。

Nextcloudはコンテナまたはマネージドホスティングで実行します。

OCCは、アプリケーションコンテナ内、またはプロバイダがサポートするシェル経由で実行してください。無関係なホスト上では実行しないでください。コンテナ名、インストールパス、PHPコマンド、サービスユーザーはデプロイメントごとに異なるため、ドキュメントを確認せずに別のイメージ用に作成されたDockerコマンドをコピーしないでください。マネージドホスティングではシェルへのアクセスが制限されている場合があります。OCCを実行できない場合は、ホスティングのコントロールパネルを使用するか、プロバイダのドキュメントに記載されている復旧方法をリクエストしてください。

アクセスが回復したことを確認してください。

OCC が成功メッセージを出力したことを確認したら、プライベート ブラウザー ウィンドウで通常の Nextcloud URL を開き、正確なユーザー名と新しいパスワードでサインインします。プライベート ウィンドウを使用すると、パスワードの問題を古いセッションやキャッシュされたログイン ページの問題と区別できます。サインイン後、アカウントに管理者権限がまだあり、管理設定を開くことができることを確認します。それでもログインに失敗した場合は、ユーザー名、認証バックエンド、サーバー ログ、および OCC が正しいインスタンスに対して実行されたかどうかを再度確認してください。間違ったコピーに対してリセットを繰り返しても、アクティブなサーバーは修復されません。

公式資料

• Nextcloudの管理者パスワードを紛失した場合のリセット方法に関するガイド
• Nextcloud OCCのユーザーおよびグループコマンド
• Nextcloud OCC コマンドリファレンス