クイックスタート

前提条件#

• Docker と Docker Compose v2
• roji がインストール済みで起動中（ インストールを参照）

セットアップ確認#

roji doctor

すべてのチェックがパスするはずです。問題がある場合は sudo roji doctor --fix で自動修復できます。

既存プロジェクトにrojiを追加#

既存の docker-compose.yml に roji ネットワークを追加します：

services:
  myapp:
    image: your-app
    expose:
      - "3000"
    networks:
      - roji      # これを追加

networks:
  roji:           # これを追加
    external: true

プロジェクトを起動：

docker compose up -d

https://myapp.dev.localhost を開く — それだけです！

ダッシュボードを確認#

https://roji.dev.localhost を開くと、ライブダッシュボードが表示されます：

• 登録済みの全ルート
• リアルタイムリクエストログ
• Docker Composeプロジェクト操作（起動/停止/再起動）
• プロジェクト履歴とクイックスタートボタン

ダッシュボードはServer-Sent Eventsによりページ更新なしで自動更新されます。

よくあるパターン#

カスタムホスト名：

labels:
  - "roji.host=myapp.dev.localhost"

パスベースルーティング（1つのホストに複数サービス）：

labels:
  - "roji.host=myapp.dev.localhost"
  - "roji.path=/api"

特定ポート（複数ポートが公開されている場合）：

labels:
  - "roji.port=3000"

複数プロジェクト — 各プロジェクトを roji ネットワークに接続するだけ。各サービスが自動的に *.dev.localhost サブドメインを取得します。

次のステップ#

• 最初のサービス — マルチサービスプロジェクトをゼロから構築
• Dockerラベル — すべてのラベルオプション
• 設定 — 設定ファイルと環境変数