オンプレミス#
On Premise により、エンタープライズのワークスペースでLinux、macOS、またはWindowsのコンピュータ上のデータセットとコンピュートを利用できるようになります。ソースの画像や動画はコンピュータ上に残ります。トレーニングの動作は他のremote trainingの場所と同様であり、メトリクスはPlatformにストリーミングされ、完了したモデルウェイトはダウンロード、予測、エクスポート、デプロイのためにアップロードされます。
セットアップは1つのコマンドで完了します。PlatformがOSを検出し、適切なフォルダ位置を自動入力し、必要に応じてDockerをインストールして、接続の進行状況をリアルタイムで表示します。
仕組み#
flowchart LR
A[Your browser] <-->|Interface, labels, and progress| B[Ultralytics Platform]
A <-->|Dataset previews| C[Your On Premise computer]
B <-->|Jobs, metrics, and model weights| C
C --- D[(Dataset folder)]
C --- E[(Models folder)]データの境界#
| データ | ご自身のOn Premiseコンピュータ | Platformおよびクラウドサービス |
|---|---|---|
| ソースおよび派生データセットのピクセルデータ | 取り込み、プレビュー、トレーニングをローカルで維持 | 保存、ログ記録、処理を一切行わない |
| クラス、ラベル、アノテーション | ソースラベルは取り込み時に読み込まれます | Platform上でアノテーションできるように、標準のデータセットメタデータとして保存されます |
| トレーニングモデル | 実行結果、ベストチェックポイント、その他のトレーニング成果物は、モデルフォルダに書き込まれます | ベストチェックポイントは、ダウンロード、予測、エクスポート、デプロイのためにアップロードされますが、その他の成果物はコンピュータ内に保持されます |
モデルの重み、ラベル、アノテーション、およびメトリクスには、画像から学習された情報が含まれる可能性があります。データセットのピクセルデータのみが厳格なローカル限定の境界となります。クラウド予測は、ユーザーがそのクラウドワークフローに別途送信した画像のみを処理します。ワーカーがマウントされたデータセットから画像を転送することはありません。
始める前に#
データセットにアクセスでき、Platformの使用中も電源が入ったままになるLinuxコンピューター、Apple silicon Mac、または64ビットのWindowsコンピューターを選択します。データセット、モデルの実行、Dockerイメージ用に十分な空きストレージを確保し、コンピューターがアウトバウンドのHTTPS接続を行えることを確認してください。
GPUはオプションです。すべてのコンピュータでデータセットの取り込みとCPUによるモデルトレーニングが可能です。互換性のあるNVIDIA GPUを使用すると、大規模なトレーニングジョブを高速化できます。
社内ネットワークでアウトバウンドトラフィックが制限されている場合は、セットアップ前にUltralytics Platform、Dockerレジストリ、およびPythonパッケージのダウンロード先へのHTTPSアクセスを許可してください。
コンピュータの接続#
- データセットにアクセスできるコンピュータ上でUltralytics Platformを開きます。
Settings > Integrationsに移動し、統合リストからOn Premiseを選択します。- 自動入力されたDataset folder on this machineおよびModels folder on this machineのパスを確認します。
- Create install commandを選択します。
- ダイアログに表示されたターミナルを開き、コマンドをコピーして貼り付け、Enterキーを押します。
- 進捗インジケーターにConnectedが表示されるまで、Integrationsページを開いたままにします。

コマンドをコピーする前に、Platformがフォルダと一度限りの接続トークンを自動的に入力します。生成されるコマンドは以下の形式に従います:
Terminalを開いて貼り付け:
curl -fsSL 'https://platform.ultralytics.com/api/workers/install?os=linux' \
| sudo sh -s -- \
"/datasets" \
"/models" \
"YOUR_CONNECTION_TOKEN"Platformには接続トークンが自動的に含まれます。これは、このコンピュータがワークスペースへの接続を許可されていることを証明するもので、10分で期限切れとなり、1回のみ有効です。手動で入力する必要はありません。生成されたコマンドが有効な間は、決して共有しないでください。
デフォルト設定のままで動作します:
| Linux | macOSおよびWindows | |
|---|---|---|
| データセットフォルダ | /datasets | ~/Ultralytics/datasets |
| モデルフォルダ | /models | ~/Ultralytics/models |
セットアップコマンドによりこれらのフォルダが作成され、必要に応じてDockerがインストールおよび起動され、コンピュータの起動時に接続が再開されるように構成されます。セットアップ完了前に、OSからインストールや再起動の承認を求められる場合があります。
Dockerベースイメージ#
インストーラーは1つのコンテナを実行し、ホスト用のofficial Ultralytics base imageを選択します。
| ホスト | ベースイメージパターン |
|---|---|
| Apple siliconまたはARM64 Linux | ultralytics/ultralytics:<version>-arm64 |
| x86-64 CPU | ultralytics/ultralytics:<version>-cpu |
| サポートされているNVIDIA GPUを搭載したx86-64 | ultralytics/ultralytics:<version> |
インストーラーは、ホスト向けにバージョンが固定された公式イメージを選択します。ワーカーはUltralyticsを再インストールすることなく、接続依存関係を追加します。セットアップ中にCUDAを検出するため、NVIDIAホストではCPUとGPUの別々のワーカーではなく、1つのコンテナーが実行されます。最適なチェックポイントのアップロード後、Platformのクラウドサービスがモデルの予測とエクスポートを処理します。
CPUのセットアップにはガイド付きインストール以外のものは必要ありません。Linuxでは、NVIDIA GPUのアクセラレーションにDocker >= 28.2およびNVIDIA Container Toolkit >= 1.18が必要です。インストーラーはレガシーな --gpus all ではなくCDIの --device 予約を使用するため、ホストデーモンのリロード後もGPUアクセスが維持されます。Windows上のDocker Desktopでは、NVIDIA CDIデバイスが利用できないため、サポートされているNVIDIAデバイス予約を使用します。プラットフォームはサポートされているGPUパスを自動的に検出し、セットアップの詳細については Docker Quickstart Guide を参照してください。
データセットの追加#
- 設定したデータセットフォルダ内にデータセットを配置します。
- Platformで、New Dataset > On Premise を選択します。
- 接続したコンピュータを選択します。
- データセットフォルダを参照し、タスクを選択してCreateを選択します。
Platformがローカルでデータセットをインデックス化し、アップロードやクラウドストレージのデータセットと同じギャラリーで開きます。ピクセルデータをアップロードすることなく、画像のプレビュー、ラベルの確認、データセットのフィルタリング、アノテーションを行うことができます。
サポートされているデータ#
On Premiseは、アップロードされたデータと同じ取り込み形式およびコンピュータビジョンタスクをサポートしています:
- 画像および動画
- ZIP, TAR, TAR.GZ, TGZアーカイブ
- Ultralytics NDJSONおよびCOCO JSON
- YOLOデータセットおよび分類用フォルダ
- 検出、セグメンテーション、ポーズ推定、回転バウンディングボックス(OBB)、および分類タスク
Platformは、一般的なデータセットのレイアウト、クラス、ラベル、およびトレーニング/検証/テスト分割を自動的に認識します。Platformはソースファイルを読み取り専用として扱い、サイズ変更、再エンコード、編集、削除を行うことはありません。
プレビューとアノテーション#
画像を開くと、ブラウザが接続されたコンピュータから直接画像を読み込みます。証明書、ホスト名、VPN、プレビュー構成の設定は不要です。
アノテーションとデータセットの構成はPlatformワークスペースに保存されますが、Platform上での編集が元のソース画像やラベルファイルを変更することはありません。
モデルのトレーニング#
通常のPlatformのトレーニングダイアログからトレーニングを開始します:
- プロジェクトを開き、New Modelを選択します。
- On Premiseデータセットを選択します。
- モデルとトレーニング設定を選択します。
- トレーニングを開始します。
Platformは接続されたコンピュータ上でジョブを実行します。利用可能なNVIDIA GPUを使用するか、自動的にCPUにフォールバックするため、Macでも専用のGPUハードウェアなしでCOCO8上のYOLO26nのような小規模なモデルをトレーニングできます。
トレーニングファイルは、実行中、設定されたモデルフォルダに書き込まれます。Ultralyticsパッケージは、顧客管理のマシンと同様のリモートトレーニング用コールバックを使用します。進捗状況やメトリクスはPlatformにストリーミングされ、ベストチェックポイントはPlatformストレージにアップロードされます。また、完了したモデルは既存のダウンロード、予測、エクスポート、デプロイのパスで使用可能になります。その他のトレーニング成果物はモデルフォルダに保持されます。On PremiseでのトレーニングはPlatformのコンピューティングクレジットを消費せず、Platformがトレーニングジョブをクラウドコンピューティングに送信することもありません。
接続の管理#
Settings > Integrationsを開いて、コンピュータとそのCPUまたはGPUが利用可能かどうかを確認します。アクセスを更新するために再接続したり、不要になった場合に接続を解除したりできます。
切断しても、新しいジョブやプレビューは実行できなくなりますが、データセットやソースファイルがコンピュータから削除されることはありません。アップロード済みのモデルは、引き続きPlatformで利用可能です。
セットアップが完了しない場合#
- Dockerが権限を要求する場合: プロンプトを承認し、Dockerの起動を待ちます。セットアップが自動的に続行されます。
- Windowsで再起動を求められた場合: コンピュータを再起動し、
Settings > Integrationsに戻って新しいインストールコマンドを作成します。 - セットアップコマンドの期限が切れた場合: 新しいインストールコマンドを作成してください。各コマンドは一時的なもので、1回のみ有効です。
- 接続がオフラインのままの場合: Docker Desktopを開き、新しく生成されたコマンドを再実行し、On Premiseが実行中であることを報告するまでターミナルを開いたままにしてください。
- プレビューが読み込まれない場合: 接続されたコンピュータ上のブラウザでPlatformを開いてください。データセットのプレビューは、そのコンピュータから直接提供されます。
また、Datasets、Annotation、およびTrainingも参照してください。