Ubuntu 24.04 LTS に ONLYOFFICE Workspace をセットアップする方法

ONLYOFFICE Workspaceは、オンライン文書編集機能と幅広いコラボレーションポータルを組み合わせたサービスです。Ubuntu 24.04 LTSでは、公式のONLYOFFICE Workspace CommunityインストールスクリプトとDockerを使用することで、最も簡単にサーバーをセットアップできます。DockerはWorkspaceコンポーネントを独立したコンテナ内で実行するため、手動で構築するよりもデプロイメントの再現や更新が容易になります。

このガイドではコミュニティ版を使用し、初めて管理者になる方にとって実用的な選択肢として、オプションのONLYOFFICEメールサーバーなしでWorkspaceをインストールする方法から始めます。これにより、初回導入時にDNSとメール配信に関する要件が不要になります。メールサーバーは、必要に応じて後からコントロールパネルから追加できます。

2026年10月現在、DockerはUbuntu 24.04 LTS（Noble）を正式にサポートしています。ONLYOFFICEの最新のWorkspace Communityドキュメントでは、少なくとも4コアCPU、8GBのRAM、40GBの空きディスク容量、6GBのスワップ領域を備えたamd64 Linuxホストを推奨しています。ベンダーは、よりスムーズなデプロイのために、より多くのCPUとRAMを推奨しています。本番サーバーにデプロイする前に、最新のONLYOFFICE Workspace Community DockerインストールガイドとDockerのUbuntuインストールドキュメントを確認してください。

始める前に必要なもの

Ubuntu 24.04 LTSサーバーまたは仮想マシン、権限を持つアカウントsudo、パッケージやコンテナイメージをダウンロードするためのインターネット接続、そしてワークスペースサービスに必要な十分な空きリソースが必要です。ポータルを他のコンピューターからアクセスできるようにするには、サーバーに安定したLANアドレスまたはパブリックIPアドレスも必要です。

amd64とは、IntelおよびAMDプロセッサで使用される一般的な64ビットx86サーバーアーキテクチャを指します。Dockerが他のアーキテクチャをサポートしているからといって、ONLYOFFICE Workspaceも自動的にサポートするとは限りません。現在のWorkspaceの要件では、amd64 Linuxが明示的に指定されています。

ステップ1：Ubuntuホストに十分なリソースがあることを確認する

ターミナルを開くか、SSH経由でサーバーに接続します。以下を実行します。

uname -m
free -h
df -h

uname -mはプロセッサのアーキテクチャを表示します。互換性のある x86-64 ホストでは、通常 が表示されますx86_64。free -hは RAM とスワップ領域を表示し、 はdf -h空きディスク容量を人間が読みやすい単位で表示します。

メモリやストレージ容量が不足しているサーバーでは、作業を続行しないでください。インストールは完了しても、後で編集やインデックス作成などの負荷がかかると失敗する可能性があります。このような場合、容量不足を解消するよりも診断が困難になります。

ステップ2：Dockerの公式UbuntuリポジトリからDocker Engineをインストールする

Docker Engineは、ワークスペースのデプロイメントで使用されるコンテナを作成および実行するサービスです。Dockerの現在のUbuntu向け手順はUbuntu 24.04 LTSをサポートしており、通常のサーバーインストールにはDocker独自のAPTリポジトリを使用することを推奨しています。

まず、基本的なリポジトリツールをインストールしてください。

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

Dockerの現在の署名キーとリポジトリを追加します。

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

次に、Docker EngineとComposeプラグインをインストールします。

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

サービスが実行されていることを確認してください。

sudo systemctl status docker --no-pager

ステップ3：ONLYOFFICEを関与させる前にDockerを検証する

この簡単なチェックで、Dockerの問題とWorkspaceの問題を区別できます。実行してください。

sudo docker run --rm hello-world

Dockerは小さなテストイメージをダウンロードし、コンテナを起動し、確認メッセージを表示して終了します。この処理が失敗した場合は、ワークスペーススクリプトの実行を続行する前に、まずDockerの問題を修正してください。

docker初心者によくある間違いは、からの権限エラーをONLYOFFICE の失敗として扱うことです。このガイドでは意図的にを使用しているsudo dockerため、アカウントを Docker グループに追加する必要はありません。Docker は、そのグループへの参加は実質的にルートレベルの制御を付与することになるため、コマンドを短縮するためだけに安易にユーザーを追加しないでくださいと警告しています。

ステップ4：公式のONLYOFFICE Workspaceインストーラーをダウンロードします。

ONLYOFFICEは、独自のダウンロードドメインでインストールスクリプトを公開しています。直接ダウンロードしてください。

curl -O https://download.onlyoffice.com/install/workspace-install.sh

ダウンロードした管理スクリプトを実行する前に、その内容を検査することをお勧めします。

less workspace-install.sh

q終了するにはを押してくださいless。これはスクリプトの安全性を証明するものではありませんが、root 権限を与える前にソースコードを確認し、予期しないコマンドに気づく機会を与えてくれます。

ステップ5：まずメールサーバーなしでWorkspaceをインストールします

初回展開時には、ONLYOFFICE Mailをスキップして公式スクリプトを実行してください。

sudo bash workspace-install.sh -ims false

この-ims falseパラメータは「メールサーバーコンポーネントをインストールしない」という意味です。これにより、初期設定はワークスペースポータル、ドキュメントエディター、および管理コンポーネントに集中できます。ONLYOFFICEのドキュメントには、メールは後からコントロールパネルからインストールできると記載されています。

既に適切に設定されたメールサービスドメインをお持ちで、完全インストールをご希望の場合は、ONLYOFFICE のドキュメントにあるこちらのフォームをご参照ください。

sudo bash workspace-install.sh -md "mx1.example.com"

実際のメールサービスホスト名に置き換えてくださいmx1.example.com。ホスト名はサーバーに解決できる必要があり、メールドメインには適切なDNSレコードが必要です。インストーラーを続行させるためだけに架空のホスト名を使用しないでください。DNS設定の誤りは、本来であれば正常に動作するはずのWorkspaceの展開をメール配信の問題に陥らせる最も簡単な方法の一つです。

ステップ6：コンテナが実際に実行されていることを確認する

スクリプトの実行が完了したら、実行中のコンテナを検査します。

sudo docker ps

コンテナ名がオンラインで見かける例と異なっていても心配ありません。名前や内部コンポーネントはリリースごとに変更される可能性があります。重要なのは、期待される ONLYOFFICE コンテナが存在し、その状態が繰り返し再起動や終了ではなく実行中であることです。

コンテナが繰り返し再起動する場合は、実際の名前を調べてからdocker ps -a、以下を実行してください。

sudo docker logs --tail 100 CONTAINER_NAME

CONTAINER_NAMEDockerが表示する名前に置き換えてください。これは、チュートリアルから古いコンテナ名をコピーするよりも安全です。

ステップ7：サーバーの実際のネットワークアドレスを使用してポータルを開きます。

サーバーのアドレスは以下で確認できます。

hostname -I

サーバーにアクセスできるブラウザで、以下を開いてください。

http://SERVER_IP

localhostONLYOFFICEのDockerガイドでは、ポータルを検証する際に、マシンのネットワークIPアドレスを使用するよう具体的に推奨しています127.0.0.1。インストール後、初期起動には数分かかる場合があるため、少し時間がかかったからといって、必ずしもデプロイが失敗したとは限りません。

ステップ8：管理者設定を完了する

初回起動ページでは、ポータル管理者アカウントの作成を求められます。強力なパスワードを設定し、有効なメールアドレスを入力し、適切な言語とタイムゾーンを選択して、ライセンス条項に同意してください。ONLYOFFICEによると、デフォルトのパスワードポリシーでは8～120文字が必須ですが、後でセキュリティ設定を強化することも可能です。

初期ウィザードが完了したら、ドキュメントモジュールを開いてテストドキュメントを作成できることを確認してください。サインインが成功すれば、ポータルにアクセスできることが証明されます。ドキュメントを開いて編集することで、ドキュメント編集コンポーネントが正しく接続されていることも確認できます。

ユーザーを招待する前にインストールを安全にしてください

サーバーを一時的なラボ環境以外で使用する場合は、通常のHTTPからHTTPSに移行してください。ONLYOFFICEのコントロールパネルでは、Let's Encrypt証明書を生成して適用するか、既存の証明書と秘密鍵を受け入れることができます。組み込みのLet's Encryptワークフローでは、証明書の発行中にポート80にアクセスできる必要があります。詳細については、ONLYOFFICEの公式HTTPS設定ガイドを参照してください。

また、実際に必要なネットワークポートを確認してください。ONLYOFFICEはワークスペースコミュニティのポートリファレンスを公開しています。その表に記載されているからといって、データベースポートや内部サービスポートをインターネットに公開しないでください。

UbuntuにはホストファイアウォールであるUFWが含まれていますが、Docker固有の重要な注意点があります。Dockerのドキュメントには、公開されたコンテナポートはUFWルールをバイパスできると警告されています。つまり、「UFWでブロックした」だけでは、Dockerが公開したポートにアクセスできないという十分な証拠にはなりません。Dockerのファイアウォールの動作を確認し、インターネットに接続するサーバーの場合は、UFWだけで全てのコンテナポートを制御できると想定するのではなく、適切に設計されたホストファイアウォールポリシーまたはアップストリームファイアウォールポリシーを使用してください。Ubuntu独自のファイアウォールリファレンスは、Ubuntu Serverファイアウォールドキュメントで参照できます。

よくある問題とその最初に確認すべきこと

インストーラーによると、必要なポートが既に使用されています。

ランダムなサービスを停止する前に、リスナーを確認してください。

sudo ss -ltnp | grep -E ':(80|443)\b'

Apache、Nginx、他のコンテナ、または管理パネルが既にそのポートを所有している場合は、どのサービスがそのポートを保持するかを決定してください。本番環境のWebサーバーを安易に停止しないでください。

インストール後、ポータルが読み込まれません

まずDockerを確認してください。

sudo systemctl is-active docker
sudo docker ps -a

Dockerが非アクティブ状態の場合は、起動してジャーナルを確認してください。ワークスペースコンテナが起動しているにもかかわらずページにアクセスできない場合は、正しいサーバーIPアドレスを使用していること、およびルーティング、クラウドセキュリティグループ、アップストリームファイアウォールが必要なWebトラフィックを許可していることを確認してください。

インストール中にサーバーのメモリが不足する

再確認してくださいfree -h。ワークスペースのスクリプトベースのガイドでは、少なくとも6GBのスワップ領域が必要とされており、RAMは最低8GBとされています。非常に小さなVMでは、複数のイメージが同時に初期化される際に不安定になる可能性があります。メモリ不足を補うために各サービスを調整するよりも、より大きなVMに移行する方が通常は問題が軽減されます。

後でONLYOFFICEメールが必要になります

Workspaceを再インストールする必要はありません。ONLYOFFICEのドキュメントには、コントロールパネルの「更新」ページからメールサーバーを追加する方法が記載されています。追加する前に、実際のサービスホスト名とそのDNSレコードを準備してください。既存のWorkspaceインストールにメールを追加する方法については、ONLYOFFICEのガイドを参照してください。

インストールスクリプトの代わりにDocker Composeを使用する方がよさそうです。

デプロイメント定義をより細かく制御したい場合は、この方法が有効です。ONLYOFFICEの現在のCompose手順では、Ubuntu 22.04以降でDocker Compose 2.16.0以降が必要であり、管理者はcgroupワークスペースYAMLファイル内の該当行を有効にするよう指示されています。Ubuntu 24.04は、この「22.04以降」のカテゴリに該当します。無関係なチュートリアルから古いComposeファイルをコピーするのではなく、ONLYOFFICEの公式Docker Composeガイドに従ってください。

セットアップが本当に完了したかどうかを確認する方法

正常にインストールされている状態には、いくつかの独立した兆候があります。Dockerがアクティブであること、ワークスペースコンテナが稼働し続けていること、サーバーの実際のネットワークアドレスを使用して別のマシンからポータルが開くこと、管理者がサインインできること、そしてテストドキュメントがブラウザのエディタで開くことなどです。サービスを一般公開する場合は、ブラウザが信頼する証明書を使用してHTTPSも動作させる必要があります。

Ubuntu 24.04 を初めて導入する場合、これらのチェックが完了したら作業を中断し、メール、カスタムリバースプロキシ、サードパーティ製ストレージ、認証統合などをすぐに追加するよりも良いでしょう。一度に 1 つの機能を追加し、検証を行い、DNS、ファイアウォール、コンテナの変更を記録しておきましょう。そうすることで、後々のトラブルシューティングがはるかに容易になります。