LinuxからONLYOFFICE Document Serverを完全にアンインストールする方法

ONLYOFFICE Document Server の削除に失敗すると、サービス ファイル、構成ファイル、データ ディレクトリ、Docker ボリューム、またはパッケージ マネージャーの依存パッケージが残ってしまう可能性があります。完全に安全に削除するには、インストール方法を特定し、ONLYOFFICE にアクティブなセッションを閉じさせ、該当するパッケージまたはコンテナを削除してから、永続データと共有サービスを検査し、その後で他のものを削除するようにしてください。

サーバーにドキュメント、必要なキャッシュファイル、証明書、またはカスタム設定が残っている場合は、まずバックアップを作成してください。Document Server をアンインストールすると、Nextcloud、ownCloud、またはそれに接続する他のアプリケーションに影響が出る可能性があります。また、「ONLYOFFICE を削除」しても、「PostgreSQL、Nginx、RabbitMQ、Redis、または共有フォントを削除」するとは限りません。これらは他のソフトウェアで使用されている可能性があるためです。

アンインストールする前に、インストールタイプを確認してください。

まずパッケージデータベースとSnapを確認してください。

dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice

これらのコマンドは読み取り専用です。パッケージマネージャの結果が空白であっても、別の方法でインストールされた場合はソフトウェアが存在しないとは証明されません。Docker の場合、コンテナとイメージの一覧を表示するには、次のコマンドを実行します。

docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice

LinuxホストでDocker Composeが実行されている場合は、先に進む前にComposeプロジェクトとそのボリューム宣言を確認してください。ONLYOFFICE DocsがKubernetes上のHelmでインストールされている場合は、Linuxパッケージコマンドではなく、チャートのアンインストール手順を使用してください。

DEBまたはRPMのインストールを削除するにはどうすればよいですか？

1. 作業内容を保存し、ユーザーを正常に切断する

ONLYOFFICEのLinux削除ガイドで説明されているパッケージのインストールについては、パッケージを削除する前にシャットダウン準備スクリプトを実行してください。

sudo documentserver-prepare4shutdown.sh

このスクリプトはアクティブなセッションを閉じ、ドキュメントが確実に保存されるようにします。ONLYOFFICEによると、最大5分かかる場合があります。この手順はメンテナンス期間中に実行し、接続中のユーザーに事前に通知してください。コマンドが見つからない場合は、インストールされているパッケージを確認し、無関係なスクリプトを使用するのではなく、該当するエディションの公式削除ページを参照してください。

2. UbuntuまたはDebianでパッケージを削除します

コミュニティエディションの公式パッケージ名は次のとおりですonlyoffice-documentserver。

sudo apt purge onlyoffice-documentserver

パッケージ名はエディションによって異なります。公式の開発者版削除ガイドでは、 を使用していますonlyoffice-documentserver-de。 で表示される正確な名前を確認しdpkg -l、対応するベンダーの手順に従ってください。似た名前のパッケージを推測で削除しないでください。

APT purgeはパッケージのバイナリとパッケージ設定を削除しますが、ONLYOFFICEによると、パッケージと共にインストールされた依存関係は残ります。確認する前にAPTの提案内容を確認してください。apt autoremove自動実行は避けてください。まずパッケージリストを読み、他のサービスで使用されているものは残しておきましょう。

3. CentOSまたは互換性のあるシステムからRPMパッケージを削除します。

Community Editionの削除ページには、CentOS用の以下のコマンドが記載されています。

sudo yum remove onlyoffice-documentserver

DNFを使用するシステムでは、RPMによって報告されたパッケージ名を使用し、確認する前に提案されたトランザクションを確認してください。

sudo dnf remove onlyoffice-documentserver

エディションやリポジトリの違いにより、パッケージ名が変わる場合があります。ONLYOFFICEの公式手順書にはCentOSのyumコマンドが具体的に記載されていますので、Enterprise版またはDeveloper版を削除する前に、ご使用のディストリビューションにおける同等のパッケージ名をご確認ください。

残りのファイルと依存関係はどうすればよいですか？

パッケージ削除時にディレクトリが空でないと報告された場合、ONLYOFFICE は/etc/onlyoffice、/var/www/onlyoffice手動で削除できるディレクトリとして と をリストアップします。まず、これらのディレクトリを調べて、保持したい設定、証明書、またはファイルをコピーしてください。その後、サーバーが廃止され、ディレクトリに他のアプリケーションのデータが含まれていない場合に限り、指定されたパスのディレクトリを削除します。

sudo rm -rv /etc/onlyoffice /var/www/onlyoffice

この対象コマンドをワイルドカード（例：）に置き換えないでくださいrm -rf /var/*/onlyoffice*。残りのサービスとパッケージの状態を確認してください。

systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice

パッケージマネージャは、Nginx、PostgreSQL、RabbitMQ、Redis、およびフォントパッケージが依存関係または前提条件であるため、インストールされたままになっている場合があります。他のアプリケーションで使用されていないことを確認してから、これらのパッケージを削除してください。DebianまたはUbuntuでは、パッケージの削除を検討する前に、逆依存関係を確認してください。RPMベースのシステムでは、それらに依存するサービスとパッケージを確認してください。ONLYOFFICEリポジトリがこのサーバー専用に追加された場合は、構成ファイルを確認した後、リポジトリエントリと署名キーを個別に削除できます。他のONLYOFFICE製品で使用されている共有リポジトリまたはキーは削除しないでください。

リバースプロキシとファイアウォールの設定も確認してください。NginxサイトファイルでONLYOFFICEホスト名またはプロキシ宛先を検索し、ドキュメントサーバー専用のサーバーブロックのみを編集してください。関連性のない仮想ホストはそのまま残してください。TLS証明書は別途管理されており、他のサイトでも必要となる場合があります。

Dockerのインストールを削除するにはどうすればよいですか？

まず、正確なComposeプロジェクトまたはコンテナを特定します。Composeのインストールの場合、関連するComposeファイルを含むディレクトリに移動し、プロジェクトを停止します。

docker compose down

これによりプロジェクトのコンテナとネットワークは削除されますが、名前付きボリュームは通常保持されます。これは、再インストールする場合や保存されたデータが必要な場合に便利です。完全に削除する場合は、削除する前にComposeファイルを確認し、ボリュームの一覧を確認してください。

docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'

ONLYOFFICEの公式Dockerイメージには、永続パス（/var/log/onlyoffice、、/var/www/onlyoffice/Dataなど/var/lib/onlyoffice）が記載されています。PostgreSQLデータも別途保存できます。Composeの設定では、これらのパスを名前付きボリュームまたはホストディレクトリにマッピングできます。必要な証明書やデータはバックアップしてください。このドキュメントサーバーのデプロイメントにのみ属することが確認できたボリュームとバインドマウントされたディレクトリのみを削除してください。

レビュー後、Composeプロジェクトは、以下のコマンドで宣言された名前付きボリュームを削除できます。

docker compose down --volumes

プロジェクトの永続データを削除する場合にのみ、これを使用してください。docker volume pruneショートカットとして実行しないでください。無関係な未使用ボリュームが削除される可能性があります。で起動したコンテナの場合はdocker run、特定のコンテナを停止して削除し、マウントを個別に検査して、破棄することを選択したデータパスまたはボリュームのみを削除してください。

docker stop <container_name>
docker rm <container_name>

最後に、残りのコンテナに必要がない場合のみ、ONLYOFFICEイメージを削除します。以下のコマンドで報告されたイメージとタグを正確に使用してくださいdocker image ls。

docker image rm onlyoffice/documentserver:<tag>

公式のDockerリポジトリには、イメージのデータパスとボリュームの使用状況が説明されています。実行中のコンテナの実際のマウントポイントはデフォルト設定と異なる場合があるため、docker inspect憶測よりもComposeファイルの内容を信頼してください。

Snapパッケージをアンインストールするにはどうすればよいですか？

ONLYOFFICE Docs スナップが表示された場合snap list、公式スナップリポジトリのドキュメント削除手順は次のとおりです。

sudo snap remove onlyoffice-ds

次に、snap list再度確認してください。スナップの削除と、保持されているスナップショットまたはユーザーデータの削除は、別々の操作です。保存されているスナップショットを確認しsnap saved、破棄するONLYOFFICEスナップショットのみを削除してください。共有スナップデータやスナップショットを無差別に削除しないでください。

アンインストール後の最終確認

• 対象としたパッケージ、Snap、またはコンテナが、インストールも実行もされていないことを確認してください。
• 古いドキュメントサーバーのURLが、信頼できるネットワークまたはホスト自体から応答しなくなっていることを確認してください。
• 接続されているアプリケーションが代替のドキュメントサーバーに設定されているか、コネクタが無効になっていることを確認してください。
• Nginx、ファイアウォール、DNS、TLSの設定を確認し、ONLYOFFICE固有のエントリのみを削除してください。
• ディスク使用量とパッケージマネージャーの残りの依存関係リストを確認してください。他のサービスが必要とする場合は、共有データベース、プロキシ、メッセージブローカー、フォントを保持してください。

パッケージの削除が失敗した場合は、強制オプションを試す前に、エラーメッセージ全文を読み、パッケージの状態を確認してください。破損したメンテナースクリプトや中断されたアップグレードは、そのOSとパッケージバージョンに特有の修復を必要とする場合があります。診断せずに強制的に削除を行うと、パッケージマネージャの状態が不整合になる可能性があります。標準の削除手順が正常に機能する場合は、そちらを使用することをお勧めします。

公式資料

• ONLYOFFICE Docs Community Edition: Linux インストールの削除
• ONLYOFFICE Docs Developer Edition: Linux インストールの削除
• ONLYOFFICEドキュメントサーバーのDockerイメージと永続データパス
• ONLYOFFICE Docs Snapパッケージとアンインストール手順
• ONLYOFFICE の Kubernetes に関するドキュメント: Helm のアンインストール