2025年1月1日

Roxをはじめる

Roxへようこそ！このガイドでは、ローカルマシンでRoxをセットアップして実行する方法を説明します。

前提条件

始める前に、以下がインストールされていることを確認してください：

  • Bun >= 1.0.0
  • Docker と Docker Compose
  • PostgreSQL >= 14（またはMySQL >= 8.0、またはSQLite）

インストール手順

1. リポジトリをクローン

git clone https://github.com/Love-rox/rox.git
cd rox

2. 依存関係をインストール

bun install

3. 環境変数を設定

サンプル環境ファイルをコピーして設定：

cp .env.example .env

.envを編集して設定します。主要な変数：

  • DATABASE_URL: データベース接続文字列
  • STORAGE_TYPE: localまたはs3を選択
  • JWT_SECRET: JWTトークンの秘密鍵

4. 開発サービスを起動

Docker ComposeでPostgreSQLとDragonflyを起動：

docker compose up -d

サービスが正常に起動したか確認：

docker compose ps

5. データベースマイグレーションを実行

データベースマイグレーションを生成して実行：

bun run db:generate
bun run db:migrate

6. 開発サーバーを起動

バックエンドとフロントエンドの両方を起動：

bun run dev

または個別に起動：

# バックエンドのみ
bun run backend:dev

# フロントエンドのみ
bun run frontend:dev

サービスは以下で利用可能になります：

次のステップ

トラブルシューティング

データベース接続エラー

データベース接続エラーが発生した場合：

  • Dockerサービスが実行中か確認（docker compose ps）
  • .envのデータベース認証情報が設定と一致しているか確認
  • PostgreSQLポート（5432）が既に使用されていないか確認

ポート競合

ポート3000または3001が既に使用されている場合、変更できます：

  • バックエンド: packages/backend/.env → PORT
  • フロントエンド: packages/frontend/waku.config.ts → port