How to Change the Default Storage Location in ONLYOFFICE Workspace

Short answer: in ONLYOFFICE Workspace, the Control Panel can move portal static data away from the default local disk to a supported third-party storage service. The current official administration guide lists Amazon S3, Google Cloud Storage, Rackspace Cloud Storage, and Selectel Cloud Storage for this purpose. It does not describe a Control Panel field where you can type an arbitrary local path such as /mnt/storage.

This guide uses a clearly hypothetical example throughout. Imagine a small design agency called Northstar Studio. Its self-hosted ONLYOFFICE Workspace server is running out of local disk space because uploaded files and other portal static data have grown steadily. The administrator wants to move that portal storage to an Amazon S3 bucket while keeping the Workspace portal itself on the same server. Northstar Studio is only an illustration, not a real test or customer result.

Before changing anything, it helps to distinguish two different tasks that are often described as “changing the default storage location.” The first is switching the portal’s static-data storage from the local disk to a supported object-storage provider in the Control Panel. The second is moving the host filesystem directory used by a self-hosted Docker installation. ONLYOFFICE documents these as different layers, so the steps below focus first on the supported Control Panel method and then explain the local-disk case separately.

What changes when you select a new storage provider?

By default, ONLYOFFICE Workspace stores portal data on the local disk of the machine where Workspace is installed. The official Storage page says a connected third-party service can be used for static portal data. After you choose and connect a new provider, the page reloads and a data migration process starts. Depending on the amount of data, that migration can take time.

For Northstar Studio, the goal is therefore not “make every user save future documents into a particular folder.” It is “move the portal’s storage backend from Disk Default to the S3 bucket.” That distinction matters because user folder organization, connected third-party folders inside the Documents module, backup destinations, and the administrator-level Storage backend are separate features.

Official reference: ONLYOFFICE Help Center: Connecting third-party storages.

Step 1: Back up the portal before changing storage

A storage change starts a migration, so create a recoverable backup first. ONLYOFFICE provides backup and restore controls in the Control Panel. A backup can be stored temporarily, in the Documents module, on a computer path, or in supported third-party storage depending on the deployment and configuration.

仮にNorthstar Studioサーバーを想定した場合、管理者はストレージページを開く前に、最新のバックアップを作成し、作成されたアーカイブがどこに保存されているかを確認します。これは移行が失敗することを示すものではなく、認証情報、バケットポリシー、ネットワークアクセス、またはその他の依存関係に問題があった場合に、管理者が復旧するための手段を提供するものです。

公式リファレンス: ONLYOFFICE ヘルプセンター: コントロールパネルのバックアップと復元。

ステップ2：コントロールパネルを開き、統合を確認します。

ポータルを管理できるアカウントでサインインしてください。ワークスペースのスタートページからコントロールパネルを開くか、ポータルの設定を開き、左側のコントロールパネルのリンクをクリックしてください。サードパーティサービスは、ポータルの統合セクションで最初に接続する必要があります。接続されていない場合、ストレージページでストレージオプションが無効になります。

Northstar StudioはAmazon S3を使用する予定なので、管理者はまずAmazon S3がサードパーティサービスとして設定されていることを確認します。Google Cloud Storage、Rackspace Cloud Storage、またはSelectel Cloud Storageを選択する場合も、同様の前提条件が適用されます。

ステップ3：共通設定→ストレージを開く

コントロールパネルで、「共通設定」の下にある「ストレージ」ページに移動します。初期設定では「ディスクのデフォルト」が選択されています。ここで、ポータルの静的データを保存するサポートされているバックエンドを選択します。

サーバーのローカルディスクにのみデータを保持したい場合は、クラウドプロバイダーを選択しないでください。ディスクのデフォルト設定がローカルストレージの選択肢として残ります。ローカルデータを同じサーバー上の別のマウントポイントに移動する必要がある場合は、以下のDockerとホストパスに関するセクションに進んでください。ストレージページは、汎用的なファイルシステムパスセレクタではありません。

ステップ4：プロバイダー固有の設定を入力します

使用するプロバイダーを選択し、必要な接続情報を入力してください。Amazon S3の場合、ONLYOFFICEの最新ドキュメントには、バケットとリージョンなどのフィールドに加え、オプションでサービスURL、パススタイルの強制、HTTPの使用、暗号化関連の設定が記載されています。Google Cloud Storageはバケット名を使用し、RackspaceとSelectelは独自のコンテナとリージョンのフィールドを使用します。

Northstar Studioの例では、管理者は専用のS3バケットと適切なAWSリージョンを入力します。意図的に別のエンドポイントが必要な場合を除き、サービスURLは変更しません。認証情報と権限はWorkspaceが必要とするものだけに限定し、移行を開始する前にサーバーからストレージサービスへのネットワークアクセスを確認する必要があります。

接続ボタンをクリックする前に、実務的な確認事項を確認してください。

• バケットまたはコンテナが想定される領域に存在することを確認してください。
• 統合認証情報が有効であり、必要なオブジェクト操作に対して承認されていることを確認してください。
• Workspaceサーバーがプロバイダーのエンドポイントにアクセスできることを確認してください。
• 最新のバックアップデータは、移行対象データとは別の場所に保管してください。
• 変更は、ポータルとストレージサービスのエラーや予期せぬ容量使用量を監視できる期間にスケジュールしてください。

ステップ5：ストレージを接続し、移行が完了するまで待ちます。

「接続」をクリックします。ONLYOFFICEの公式ガイドによると、ページが再読み込みされ、データ移行プロセスが開始されます。プロバイダーが承認されたからといって、変更が完了したと決めつけないでください。新しいストレージが選択された状態でストレージページが表示されるまで待ち、ポータルが正常に動作することを確認してください。

Northstar Studioの場合、適切な検証手順としては、既存のドキュメントを複数開き、新しいファイルをアップロードし、画像やその他の静的コンテンツをプレビューし、S3バケットに新しいオブジェクトが存在するかを確認することが挙げられます。オブジェクトのレイアウトは実装の詳細であり、重要なのはポータルコンテンツが正常に動作し、新しいバックエンドが使用されていることです。ポータルでエラーが発生した場合は、追加の変更を加える前に、認証情報、バケットポリシー、リージョン、エンドポイントへの到達可能性、およびサーバーログを調査してください。

別のローカルディスクやマウントポイントを使用したい場合はどうすればよいでしょうか？

多くの「デフォルトの保存場所」に関するチュートリアルが誤解を招くのは、まさにこの点です。コントロールパネルの「ディスクのデフォルト」オプションでは、任意のホストディレクトリを選択することはできません。Dockerベースのワークスペース展開の場合、ONLYOFFICEの移行ドキュメントには、ポータルデータは/app/onlyofficeホスト上の特定のディレクトリに保存されると明記されています。また、Dockerの手動インストールに関するドキュメントでは、そのディレクトリツリーの下に、CommunityServer、DocumentServer、MailServer、ControlPanel、およびデータベース関連のディレクトリといったコンポーネントディレクトリが作成されます。

ホスト側のディレクトリをより大きなディスクに移動する必要がある場合は、コントロールパネルの設定ではなく、デプロイメントの移行として扱ってください。インストールをバックアップし、関連するコンテナを停止し、所有権と権限を保持したままデータをコピーし、特定のデプロイメントで使用されるホスト側のバインドマウントまたはDocker Composeボリューム定義を更新してから、スタックを再度起動してください。正確なComposeファイルとボリュームのマッピングはWorkspaceのインストール方法によって異なるため、別のデプロイメントから一般的なコマンドをコピーするとポータルが破損する可能性があります。

Docker Compose によるインストールの場合、実際に使用している現在のデプロイメント ファイルを参照し、公式インストール ガイド「Docker Compose を使用した ONLYOFFICE Workspace Community のインストール」と比較してください。公式の Docker ベースの Workspace レイアウトで使用されるホスト データの場所については、「ONLYOFFICE Workspace Docker 移行ガイド」を参照してください。

ポータルストレージの変更とバックアップストレージの変更にはどのような違いがありますか？

これらは別々の選択肢です。ストレージページでは、サポートされているポータルの静的データの保存場所を決定します。バックアップページでは、バックアップアーカイブの書き込み場所を決定します。たとえば、ポータルデータをディスクのデフォルトに保持したままバックアップを別の場所に書き込んだり、ポータルの静的データをS3に移動してバックアップを別の場所に保持したりできます。耐障害性の観点から、バックアップをプライマリストレージバックエンドから論理的に分離しておくと、復旧時に状況を把握しやすくなります。

あなたの状況に最適な選択肢はどれですか？

最終確認チェックリスト

• ストレージページで、目的のプロバイダーを選択します。
• 移行は単に始まったのではなく、完了した。
• 既存のファイルは正常に開き、ダウンロードできます。
• 新しいアップロードは正常に動作します。
• ユーザーはストレージ関連のエラーなくポータルにアクセスできます。
• 新しいバケットまたはコンテナは、ポータルの使用と一致するアクティビティを示しています。
• 最新のバックアップは引き続き利用可能であり、誤って移動したデータセット内にのみ保存されたわけではありません。

Northstar Studioの例では、ストレージの変更は、移行後にポータルが正常に動作し、管理者が選択したS3バックエンドがアクティブであることを確認した場合にのみ成功とみなされます。この実用的な定義は、「接続」ボタン自体がジョブ完了の証拠とみなすよりも有用です。