Merge 4f258c276d into 53fb175855

2026-05-31 19:04:39 +07:00 · 2026-05-31 01:23:29 -04:00 · 2026-05-31 01:23:29 -04:00 · 805fc0aa4f
commit 805fc0aa4f
parent 53fb175855 4f258c276d
16 changed files with 1534 additions and 0 deletions
--- a/QUICKSTART.de.md
+++ b/QUICKSTART.de.md
@ -77,6 +77,155 @@ pnpm typecheck                 # Workspace-Typecheck

 Während lokaler Entwicklung startet `tools-dev` zuerst den daemon, übergibt dessen Port an `apps/web`, und `apps/web/next.config.ts` rewritet `/api/*`, `/artifacts/*` und `/frames/*` auf diesen daemon-Port. So kann die App-Router-App ohne CORS-Setup mit dem sibling Express-Prozess sprechen.

+## Docker-Setup
+
+Führen Sie Open Design in einer vollständig containerisierten Umgebung aus, ohne Node.js oder pnpm lokal zu installieren.
+
+### Voraussetzungen
+
+* Docker Desktop
+* Docker Compose v2
+
+Überprüfen Sie, ob Docker korrekt installiert ist:
+
+```bash
+docker compose version
+```
+
+---
+
+## Open Design starten
+
+Gehen Sie vom Repository-Stammverzeichnis aus wie folgt vor:
+
+1. Wechseln Sie in das deploy-Verzeichnis und kopieren Sie die Umgebungsvorlage:
+
+   ```bash
+   cd deploy
+   cp .env.example .env
+   ```
+
+2. Generieren Sie ein sicheres Token:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Öffnen Sie `.env` in Ihrem Editor, suchen Sie `OD_API_TOKEN=` und fügen Sie das generierte Token ein.
+
+Starten Sie dann den Dienst:
+
+```bash
+docker compose up -d
+```
+
+Öffnen Sie die App in Ihrem Browser:
+
+```text
+http://localhost:7456
+```
+
+Beim ersten Start kann es einige Sekunden dauern, während Docker das neueste Image pullt.
+
+---
+
+## Häufige Docker-Befehle
+
+### Logs anzeigen
+
+```bash
+docker compose logs -f
+```
+
+### Container neu starten
+
+```bash
+docker compose restart
+```
+
+### Container stoppen
+
+```bash
+docker compose down
+```
+
+### Neuestes Image pullen
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+### Alle lokalen App-Daten entfernen
+
+```bash
+docker compose down -v
+```
+
+---
+
+## Umgebungskonfiguration
+
+Erstellen Sie eine `deploy/.env`-Datei, um die Standardkonfiguration zu überschreiben. Beginnen Sie mit dem bereitgestellten Beispiel:
+
+```bash
+cp deploy/.env.example deploy/.env
+```
+
+Bearbeiten Sie `deploy/.env`, um Ihr eigenes Token festzulegen und andere Werte nach Bedarf anzupassen:
+
+```env
+# Auf dem Host exponierter Port
+OPEN_DESIGN_PORT=7456
+
+# Container-Speicherlimit
+OPEN_DESIGN_MEM_LIMIT=384m
+
+# Erlaubte CORS-Ursprünge
+OPEN_DESIGN_ALLOWED_ORIGINS=https://yourdomain.com
+
+# Docker-Image-Tag
+OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest
+
+# Erforderliches API-Token für die Daemon-Sicherheit
+# Erzeugen Sie eines mit: openssl rand -hex 32
+OD_API_TOKEN=
+```
+
+---
+
+## Dauerhafter Speicher
+
+Open Design speichert Projekte und SQLite-Daten in einem Docker-Volume:
+
+```text
+open_design_data
+```
+
+Das Volume wird gemountet auf:
+
+```text
+/app/.od
+```
+
+Die Daten bleiben über Container-Neustarts und Image-Updates hinweg erhalten.
+
+Volume inspizieren:
+
+```bash
+docker volume inspect open-design_open_design_data
+```
+
+---
+
+## Hinweise
+
+* Der Docker-Modus ist ideal für Mitwirkende, die keine lokale Node.js- oder pnpm-Einrichtung wünschen.
+* Der Container exponiert den Produktions-Daemon-Build direkt auf Port `7456`.
+* Für Entwicklungsworkflows und erweiterte lokale Einrichtung siehe den Rest dieser Schnellstartanleitung.
+
+---
+
 ## Prüfungen für Mediengenerierung und Agent-Dispatcher

 Image-, Video-, Audio- und HyperFrames-Skills rufen die lokale `od` CLI über Umgebungsvariablen auf, die der daemon beim Start eines Agent injiziert:
--- a/QUICKSTART.fr.md
+++ b/QUICKSTART.fr.md
@ -78,6 +78,155 @@ pnpm typecheck                 # typecheck du workspace

 Pendant le développement local, `tools-dev` démarre d’abord le daemon, transmet son port à `apps/web`, puis `apps/web/next.config.ts` réécrit `/api/*`, `/artifacts/*` et `/frames/*` vers ce port daemon. L’app App Router peut ainsi parler au processus Express voisin sans configuration CORS.

+## Configuration Docker
+
+Exécutez Open Design dans un environnement entièrement conteneurisé sans installer Node.js ou pnpm localement.
+
+### Prérequis
+
+* Docker Desktop
+* Docker Compose v2
+
+Vérifiez que Docker est installé correctement :
+
+```bash
+docker compose version
+```
+
+---
+
+## Démarrer Open Design
+
+Depuis la racine du dépôt :
+
+1. Allez dans le répertoire deploy et copiez le modèle d'environnement :
+
+   ```bash
+   cd deploy
+   cp .env.example .env
+   ```
+
+2. Générez un token sécurisé :
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Ouvrez `.env` dans votre éditeur, trouvez `OD_API_TOKEN=` et collez le token généré.
+
+Lancez ensuite le service :
+
+```bash
+docker compose up -d
+```
+
+Ouvrez l'application dans votre navigateur :
+
+```text
+http://localhost:7456
+```
+
+Le premier démarrage peut prendre quelques secondes pendant que Docker télécharge la dernière image.
+
+---
+
+## Commandes Docker courantes
+
+### Voir les logs
+
+```bash
+docker compose logs -f
+```
+
+### Redémarrer les conteneurs
+
+```bash
+docker compose restart
+```
+
+### Arrêter les conteneurs
+
+```bash
+docker compose down
+```
+
+### Télécharger la dernière image
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+### Supprimer toutes les données locales de l'application
+
+```bash
+docker compose down -v
+```
+
+---
+
+## Configuration de l'environnement
+
+Créez un fichier `deploy/.env` pour remplacer la configuration par défaut. Commencez par l'exemple fourni :
+
+```bash
+cp deploy/.env.example deploy/.env
+```
+
+Modifiez `deploy/.env` pour définir votre propre token et ajuster les autres valeurs si nécessaire :
+
+```env
+# Port exposé sur l'hôte
+OPEN_DESIGN_PORT=7456
+
+# Limite de mémoire du conteneur
+OPEN_DESIGN_MEM_LIMIT=384m
+
+# Origines CORS autorisées
+OPEN_DESIGN_ALLOWED_ORIGINS=https://yourdomain.com
+
+# Tag de l'image Docker
+OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest
+
+# Token API requis pour la sécurité du daemon
+# Générez-en un avec : openssl rand -hex 32
+OD_API_TOKEN=
+```
+
+---
+
+## Stockage persistant
+
+Open Design stocke les projets et les données SQLite dans un volume Docker :
+
+```text
+open_design_data
+```
+
+Le volume est monté sur :
+
+```text
+/app/.od
+```
+
+Les données persistent entre les redémarrages de conteneurs et les mises à jour d'image.
+
+Inspectez le volume :
+
+```bash
+docker volume inspect open-design_open_design_data
+```
+
+---
+
+## Remarques
+
+* Le mode Docker est idéal pour les contributeurs qui ne souhaitent pas d'installation locale de Node.js ou pnpm.
+* Le conteneur expose la build de production du daemon directement sur le port `7456`.
+* Pour les workflows de développement et la configuration locale avancée, consultez le reste de ce guide de démarrage rapide.
+
+---
+
 ## Checks de génération média / agent dispatcher

 Les Skills image, vidéo, audio et HyperFrames appellent la CLI locale `od` via des variables d’environnement injectées par le daemon lorsqu’il lance un agent :
--- a/QUICKSTART.ja-JP.md
+++ b/QUICKSTART.ja-JP.md
@ -77,6 +77,155 @@ pnpm typecheck                 # workspace の typecheck

 ローカル開発中、`tools-dev` は最初に daemon を起動し、そのポートを `apps/web` に渡します。`apps/web/next.config.ts` は `/api/*`、`/artifacts/*`、`/frames/*` をその daemon ポートに書き換えるため、App Router アプリは CORS 設定なしで隣接する Express プロセスと通信できます。

+## Docker セットアップ
+
+Node.js や pnpm をローカルにインストールせずに、完全にコンテナ化された環境で Open Design を実行できます。
+
+### 必要条件
+
+* Docker Desktop
+* Docker Compose v2
+
+Docker が正しくインストールされていることを確認：
+
+```bash
+docker compose version
+```
+
+---
+
+## Open Design を起動
+
+リポジトリルートから：
+
+1. deploy ディレクトリに移動し、環境テンプレートをコピーします：
+
+   ```bash
+   cd deploy
+   cp .env.example .env
+   ```
+
+2. セキュアなトークンを生成します：
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. エディタで `.env` を開き、`OD_API_TOKEN=` を見つけて、生成したトークンを貼り付けます。
+
+サービスを起動します：
+
+```bash
+docker compose up -d
+```
+
+ブラウザでアプリを開きます：
+
+```text
+http://localhost:7456
+```
+
+初回起動時は、Docker が最新イメージをプルするため数秒かかる場合があります。
+
+---
+
+## よく使う Docker コマンド
+
+### ログを表示
+
+```bash
+docker compose logs -f
+```
+
+### コンテナを再起動
+
+```bash
+docker compose restart
+```
+
+### コンテナを停止
+
+```bash
+docker compose down
+```
+
+### 最新イメージをプル
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+### すべてのローカルアプリデータを削除
+
+```bash
+docker compose down -v
+```
+
+---
+
+## 環境設定
+
+`deploy/.env` ファイルを作成して、デフォルト設定を上書きします。提供された例から始めます：
+
+```bash
+cp deploy/.env.example deploy/.env
+```
+
+`deploy/.env` を編集して、自分のトークンを設定し、必要に応じて他の値を調整します：
+
+```env
+# ホストで公開するポート
+OPEN_DESIGN_PORT=7456
+
+# コンテナのメモリ制限
+OPEN_DESIGN_MEM_LIMIT=384m
+
+# 許可する CORS オリジン
+OPEN_DESIGN_ALLOWED_ORIGINS=https://yourdomain.com
+
+# Docker イメージタグ
+OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest
+
+# Daemon セキュリティに必要な API トークン
+# 次のコマンドで生成：openssl rand -hex 32
+OD_API_TOKEN=
+```
+
+---
+
+## 永続ストレージ
+
+Open Design はプロジェクトと SQLite データを Docker ボリュームに保存します：
+
+```text
+open_design_data
+```
+
+ボリュームは以下にマウントされます：
+
+```text
+/app/.od
+```
+
+データはコンテナの再起動とイメージ更新後も保持されます。
+
+ボリュームを確認：
+
+```bash
+docker volume inspect open-design_open_design_data
+```
+
+---
+
+## 注意事項
+
+* Docker モードは、ローカルに Node.js や pnpm をインストールしたくないコントリビューターに最適です。
+* コンテナは本番用 daemon ビルドをポート `7456` で直接公開します。
+* 開発ワークフローや高度なローカル設定については、この Quickstart ガイドの残りの部分を参照してください。
+
+---
+
 ## メディア生成 / エージェントディスパッチャーチェック

 Image、Video、Audio、HyperFrames スキルは、daemon がエージェントを起動する際に注入する環境変数を通じてローカル `od` CLI を呼び出します：
--- a/QUICKSTART.pt-BR.md
+++ b/QUICKSTART.pt-BR.md
@ -77,6 +77,155 @@ pnpm typecheck                 # workspace typecheck

 Em desenvolvimento local, o `tools-dev` sobe o daemon primeiro, repassa a porta dele para `apps/web`, e o `apps/web/next.config.ts` reescreve `/api/*`, `/artifacts/*` e `/frames/*` para essa porta de daemon, permitindo que o app do App Router fale com o processo Express irmão sem configurar CORS.

+## Configuração Docker
+
+Execute o Open Design em um ambiente totalmente conteinerizado sem instalar Node.js ou pnpm localmente.
+
+### Requisitos
+
+* Docker Desktop
+* Docker Compose v2
+
+Verifique se o Docker está instalado corretamente:
+
+```bash
+docker compose version
+```
+
+---
+
+## Iniciar o Open Design
+
+A partir da raiz do repositório:
+
+1. Vá para o diretório deploy e copie o modelo de ambiente:
+
+   ```bash
+   cd deploy
+   cp .env.example .env
+   ```
+
+2. Gere um token seguro:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Abra o `.env` no seu editor, encontre `OD_API_TOKEN=` e cole o token gerado.
+
+Em seguida, inicie o serviço:
+
+```bash
+docker compose up -d
+```
+
+Abra o aplicativo no seu navegador:
+
+```text
+http://localhost:7456
+```
+
+A primeira inicialização pode levar alguns segundos enquanto o Docker baixa a imagem mais recente.
+
+---
+
+## Comandos Docker comuns
+
+### Ver logs
+
+```bash
+docker compose logs -f
+```
+
+### Reiniciar contêineres
+
+```bash
+docker compose restart
+```
+
+### Parar contêineres
+
+```bash
+docker compose down
+```
+
+### Baixar a imagem mais recente
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+### Remover todos os dados locais do aplicativo
+
+```bash
+docker compose down -v
+```
+
+---
+
+## Configuração de ambiente
+
+Crie um arquivo `deploy/.env` para substituir a configuração padrão. Comece a partir do exemplo fornecido:
+
+```bash
+cp deploy/.env.example deploy/.env
+```
+
+Edite `deploy/.env` para definir seu próprio token e ajustar outros valores conforme necessário:
+
+```env
+# Porta exposta no host
+OPEN_DESIGN_PORT=7456
+
+# Limite de memória do container
+OPEN_DESIGN_MEM_LIMIT=384m
+
+# Origens CORS permitidas
+OPEN_DESIGN_ALLOWED_ORIGINS=https://yourdomain.com
+
+# Tag da imagem Docker
+OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest
+
+# Token de API obrigatório para segurança do daemon
+# Gere um com: openssl rand -hex 32
+OD_API_TOKEN=
+```
+
+---
+
+## Armazenamento persistente
+
+O Open Design armazena projetos e dados SQLite dentro de um volume Docker:
+
+```text
+open_design_data
+```
+
+O volume é montado em:
+
+```text
+/app/.od
+```
+
+Os dados persistem entre reinicializações de contêineres e atualizações de imagem.
+
+Inspecione o volume:
+
+```bash
+docker volume inspect open-design_open_design_data
+```
+
+---
+
+## Notas
+
+* O modo Docker é ideal para contribuidores que não desejam uma configuração local com Node.js ou pnpm.
+* O contêiner expõe a compilação do daemon de produção diretamente na porta `7456`.
+* Para fluxos de trabalho de desenvolvimento e configuração local avançada, consulte o restante deste guia de início rápido.
+
+---
+
 ## Verificações de geração de mídia / dispatcher de agente

 Skills de imagem, vídeo, áudio e HyperFrames chamam o CLI local `od` por meio de variáveis de ambiente que o daemon injeta ao spawnar um agente:
--- a/QUICKSTART.zh-CN.md
+++ b/QUICKSTART.zh-CN.md
@ -77,6 +77,155 @@ pnpm typecheck                 # 对整个 workspace 执行 typecheck

 本地开发时，`tools-dev` 会先启动 daemon，并将其端口传递给 `apps/web`，`apps/web/next.config.ts` 会将 `/api/*`、`/artifacts/*`、`/frames/*` 重写到该 daemon 端口，从而使 App Router 能够与相邻的 Express 进程通信，无需配置 CORS。

+## Docker 部署
+
+在一个完全容器化的环境中运行 Open Design，无需安装 Node.js 或 pnpm。
+
+### 环境要求
+
+* Docker Desktop
+* Docker Compose v2
+
+验证 Docker 是否正确安装：
+
+```bash
+docker compose version
+```
+
+---
+
+## 启动 Open Design
+
+从仓库根目录开始：
+
+1. 进入 deploy 目录并复制环境配置模板：
+
+   ```bash
+   cd deploy
+   cp .env.example .env
+   ```
+
+2. 生成安全令牌：
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. 用编辑器打开 `.env`，找到 `OD_API_TOKEN=`，将生成的令牌粘贴进去。
+
+然后启动服务：
+
+```bash
+docker compose up -d
+```
+
+在浏览器中打开应用：
+
+```text
+http://localhost:7456
+```
+
+首次启动可能需要几秒钟，Docker 会拉取最新镜像。
+
+---
+
+## 常用 Docker 命令
+
+### 查看日志
+
+```bash
+docker compose logs -f
+```
+
+### 重启容器
+
+```bash
+docker compose restart
+```
+
+### 停止容器
+
+```bash
+docker compose down
+```
+
+### 拉取最新镜像
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+### 删除所有本地应用数据
+
+```bash
+docker compose down -v
+```
+
+---
+
+## 环境配置
+
+创建 `deploy/.env` 文件来覆盖默认配置。从提供的模板开始：
+
+```bash
+cp deploy/.env.example deploy/.env
+```
+
+编辑 `deploy/.env` 来设置你自己的令牌并调整其他值：
+
+```env
+# 宿主机暴露的端口
+OPEN_DESIGN_PORT=7456
+
+# 容器内存限制
+OPEN_DESIGN_MEM_LIMIT=384m
+
+# 允许的 CORS 来源
+OPEN_DESIGN_ALLOWED_ORIGINS=https://yourdomain.com
+
+# Docker 镜像标签
+OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest
+
+# Daemon 安全所需的 API 令牌
+# 使用以下命令生成：openssl rand -hex 32
+OD_API_TOKEN=
+```
+
+---
+
+## 持久化存储
+
+Open Design 将项目和 SQLite 数据存储在 Docker 卷中：
+
+```text
+open_design_data
+```
+
+该卷挂载到：
+
+```text
+/app/.od
+```
+
+数据在容器重启和镜像更新后持续保留。
+
+查看卷：
+
+```bash
+docker volume inspect open-design_open_design_data
+```
+
+---
+
+## 注意事项
+
+* Docker 模式非常适合不希望在本地安装 Node.js 或 pnpm 的贡献者。
+* 容器直接在端口 `7456` 上暴露生产环境的 daemon 构建。
+* 如需开发工作流和高级本地配置，请参阅本快速上手指南的其余部分。
+
+---
+
 ## 媒体生成 / agent dispatcher 排查

 Image、video、audio、HyperFrames 等 skill 在通过 daemon 启动 agent 时，会注入环境变量以调用本地 `od` CLI：
--- a/QUICKSTART.zh-TW.md
+++ b/QUICKSTART.zh-TW.md
@ -77,6 +77,155 @@ pnpm typecheck                 # 對整個 workspace 執行 typecheck

 本地開發時，`tools-dev` 會先啟動 daemon，並將其連接埠傳遞給 `apps/web`，`apps/web/next.config.ts` 會將 `/api/*`、`/artifacts/*`、`/frames/*` 重寫到該 daemon 連接埠，從而使 App Router 能夠與相鄰的 Express 行程通訊，無需設定 CORS。

+## Docker 部署
+
+在一個完全容器化的環境中執行 Open Design，無需安裝 Node.js 或 pnpm。
+
+### 環境需求
+
+* Docker Desktop
+* Docker Compose v2
+
+驗證 Docker 是否正確安裝：
+
+```bash
+docker compose version
+```
+
+---
+
+## 啟動 Open Design
+
+從倉庫根目錄開始：
+
+1. 進入 deploy 目錄並複製環境設定範本：
+
+   ```bash
+   cd deploy
+   cp .env.example .env
+   ```
+
+2. 產生安全令牌：
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. 用編輯器開啟 `.env`，找到 `OD_API_TOKEN=`，將產生的令牌貼上。
+
+然後啟動服務：
+
+```bash
+docker compose up -d
+```
+
+在瀏覽器中開啟應用：
+
+```text
+http://localhost:7456
+```
+
+首次啟動可能需要幾秒鐘，Docker 會拉取最新映像檔。
+
+---
+
+## 常用 Docker 指令
+
+### 檢視日誌
+
+```bash
+docker compose logs -f
+```
+
+### 重新啟動容器
+
+```bash
+docker compose restart
+```
+
+### 停止容器
+
+```bash
+docker compose down
+```
+
+### 拉取最新映像檔
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+### 刪除所有本地應用資料
+
+```bash
+docker compose down -v
+```
+
+---
+
+## 環境設定
+
+建立 `deploy/.env` 檔案來覆蓋預設設定。從提供的範例開始：
+
+```bash
+cp deploy/.env.example deploy/.env
+```
+
+編輯 `deploy/.env` 來設定你的令牌並調整其他值：
+
+```env
+# 主機暴露的埠號
+OPEN_DESIGN_PORT=7456
+
+# 容器記憶體限制
+OPEN_DESIGN_MEM_LIMIT=384m
+
+# 允許的 CORS 來源
+OPEN_DESIGN_ALLOWED_ORIGINS=https://yourdomain.com
+
+# Docker 映像檔標籤
+OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest
+
+# Daemon 安全所需的 API 令牌
+# 使用以下命令產生：openssl rand -hex 32
+OD_API_TOKEN=
+```
+
+---
+
+## 持久化儲存
+
+Open Design 將專案和 SQLite 資料儲存在 Docker 卷中：
+
+```text
+open_design_data
+```
+
+該卷掛載到：
+
+```text
+/app/.od
+```
+
+資料在容器重新啟動和映像檔更新後持續保留。
+
+檢視卷：
+
+```bash
+docker volume inspect open-design_open_design_data
+```
+
+---
+
+## 注意事項
+
+* Docker 模式非常適合不想在本機安裝 Node.js 或 pnpm 的貢獻者。
+* 容器直接在連接埠 `7456` 上暴露生產環境的 daemon 建置。
+* 如需開發工作流程和進階本機設定，請參閱本快速入門指南的其餘部分。
+
+---
+
 ## 媒體生成 / agent dispatcher 問題排除

 Image、video、audio、HyperFrames 等 skill 在透過 daemon 啟動 agent 時，會注入環境變數以呼叫本地 `od` CLI：
--- a/README.ar.md
+++ b/README.ar.md
@ -319,6 +319,70 @@ DISCOVERY directives  (turn-1 form, turn-2 brand branch, TodoWrite, 5-dim critiq
 - **[open-design.ai](https://open-design.ai/)** — صفحة التنزيل الرسمية
 - **[إصدارات GitHub](https://github.com/nexu-io/open-design/releases)**

+### التشغيل باستخدام Docker
+
+قم بتشغيل Open Design دون تثبيت Node.js أو pnpm محليًا.
+
+#### المتطلبات
+
+* Docker Desktop
+* Docker Compose v2
+
+تحقق من Docker:
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### بدء تشغيل Open Design
+
+1. استنسخ المستودع، وانتقل إلى مجلد deploy، وانسخ قالب البيئة:
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. أنشئ رمزًا آمنًا:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. افتح `.env` في محرر النصوص، وابحث عن `OD_API_TOKEN=`، والصق الرمز الذي أنشأته.
+
+ثم ابدأ الخدمة:
+
+```bash
+docker compose up -d
+```
+
+افتح في المتصفح:
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### الأوامر الشائعة
+
+```bash id="gl95kp"
+# عرض السجلات
+docker compose logs -f
+
+# إعادة تشغيل الحاويات
+docker compose restart
+
+# إيقاف الحاويات
+docker compose down
+
+# سحب أحدث صورة
+docker compose pull
+docker compose up -d
+```
+
+لإعدادات Docker المتقدمة ومتغيرات البيئة، راجع [`QUICKSTART.md`](QUICKSTART.md).
+
 ### التشغيل من المصدر

 ```bash
--- a/README.de.md
+++ b/README.de.md
@ -316,6 +316,70 @@ Der schnellste Weg, Open Design auszuprobieren, ist die vorgefertigte Desktop-Ap
 - **[open-design.ai](https://open-design.ai/)** — offizielle Download-Seite
 - **[GitHub Releases](https://github.com/nexu-io/open-design/releases)**

+### Mit Docker ausführen
+
+Führen Sie Open Design aus, ohne Node.js oder pnpm lokal zu installieren.
+
+#### Voraussetzungen
+
+* Docker Desktop
+* Docker Compose v2
+
+Docker überprüfen:
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Open Design starten
+
+1. Klonen Sie das Repository, wechseln Sie in das deploy-Verzeichnis und kopieren Sie die Umgebungsvorlage:
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. Generieren Sie ein sicheres Token:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Öffnen Sie `.env` in Ihrem Editor, suchen Sie `OD_API_TOKEN=` und fügen Sie das generierte Token ein.
+
+Starten Sie dann den Dienst:
+
+```bash
+docker compose up -d
+```
+
+Öffnen Sie im Browser:
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### Häufige Befehle
+
+```bash id="gl95kp"
+# Logs anzeigen
+docker compose logs -f
+
+# Container neu starten
+docker compose restart
+
+# Container stoppen
+docker compose down
+
+# Neuestes Image pullen
+docker compose pull
+docker compose up -d
+```
+
+Für erweiterte Docker-Konfiguration und Umgebungsvariablen siehe [`QUICKSTART.de.md`](QUICKSTART.de.md).
+
 ### Aus dem Quellcode ausführen

 ```bash
--- a/README.fr.md
+++ b/README.fr.md
@ -317,6 +317,70 @@ Le moyen le plus rapide d'essayer Open Design est l'application desktop précons
 - **[open-design.ai](https://open-design.ai/)** — page de téléchargement officielle
 - **[Releases GitHub](https://github.com/nexu-io/open-design/releases)**

+### Exécuter avec Docker
+
+Exécutez Open Design sans installer Node.js ou pnpm localement.
+
+#### Prérequis
+
+* Docker Desktop
+* Docker Compose v2
+
+Vérifier Docker :
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Démarrer Open Design
+
+1. Clonez le dépôt, allez dans le répertoire deploy et copiez le modèle d'environnement :
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. Générez un token sécurisé :
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Ouvrez `.env` dans votre éditeur, trouvez `OD_API_TOKEN=` et collez le token généré.
+
+Lancez ensuite le service :
+
+```bash
+docker compose up -d
+```
+
+Ouvrez dans votre navigateur :
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### Commandes courantes
+
+```bash id="gl95kp"
+# Voir les logs
+docker compose logs -f
+
+# Redémarrer les conteneurs
+docker compose restart
+
+# Arrêter les conteneurs
+docker compose down
+
+# Télécharger la dernière image
+docker compose pull
+docker compose up -d
+```
+
+Pour la configuration avancée de Docker et les variables d'environnement, consultez [`QUICKSTART.fr.md`](QUICKSTART.fr.md).
+
 ### Exécuter depuis les sources

 ```bash
--- a/README.ja-JP.md
+++ b/README.ja-JP.md
@ -317,6 +317,70 @@ Open Design を最速で試す方法は、ビルド済みのデスクトップ
 - **[open-design.ai](https://open-design.ai/)** — 公式ダウンロードページ
 - **[GitHub リリース](https://github.com/nexu-io/open-design/releases)**

+### Docker で実行
+
+Node.js や pnpm をローカルにインストールせずに Open Design を実行できます。
+
+#### 必要条件
+
+* Docker Desktop
+* Docker Compose v2
+
+Docker を確認：
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Open Design を起動
+
+1. リポジトリをクローンし、deploy ディレクトリに移動して、環境テンプレートをコピーします：
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. セキュアなトークンを生成します：
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. エディタで `.env` を開き、`OD_API_TOKEN=` を見つけて、生成したトークンを貼り付けます。
+
+サービスを起動します：
+
+```bash
+docker compose up -d
+```
+
+ブラウザで開きます：
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### よく使うコマンド
+
+```bash id="gl95kp"
+# ログを表示
+docker compose logs -f
+
+# コンテナを再起動
+docker compose restart
+
+# コンテナを停止
+docker compose down
+
+# 最新イメージをプル
+docker compose pull
+docker compose up -d
+```
+
+Docker の詳細な設定と環境変数については [`QUICKSTART.ja-JP.md`](QUICKSTART.ja-JP.md) を参照してください。
+
 ### ソースから実行

 ```bash
--- a/README.ko.md
+++ b/README.ko.md
@ -316,6 +316,70 @@ Open Design을 가장 빠르게 사용해 보는 방법은 사전 빌드된 데
 - **[open-design.ai](https://open-design.ai/)** — 공식 다운로드 페이지
 - **[GitHub 릴리스](https://github.com/nexu-io/open-design/releases)**

+### Docker로 실행
+
+로컬에 Node.js나 pnpm을 설치하지 않고 Open Design을 실행할 수 있습니다.
+
+#### 요구 사항
+
+* Docker Desktop
+* Docker Compose v2
+
+Docker 확인:
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Open Design 시작
+
+1. 리포지토리를 클론하고 deploy 디렉토리로 이동한 후 환경 템플릿을 복사합니다:
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. 보안 토큰을 생성합니다:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. 편집기에서 `.env`를 열고 `OD_API_TOKEN=`을 찾아 생성된 토큰을 붙여넣습니다.
+
+서비스를 시작합니다:
+
+```bash
+docker compose up -d
+```
+
+브라우저에서 엽니다:
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### 일반 명령어
+
+```bash id="gl95kp"
+# 로그 보기
+docker compose logs -f
+
+# 컨테이너 재시작
+docker compose restart
+
+# 컨테이너 중지
+docker compose down
+
+# 최신 이미지 가져오기
+docker compose pull
+docker compose up -d
+```
+
+고급 Docker 구성 및 환경 변수는 [`QUICKSTART.md`](QUICKSTART.md)를 참조하세요.
+
 ### 소스에서 실행

 ```bash
--- a/README.pt-BR.md
+++ b/README.pt-BR.md
@ -317,6 +317,70 @@ A maneira mais rápida de experimentar o Open Design é o aplicativo desktop pr
 - **[open-design.ai](https://open-design.ai/)** — página oficial de downloads
 - **[Releases do GitHub](https://github.com/nexu-io/open-design/releases)**

+### Executar com Docker
+
+Execute o Open Design sem instalar Node.js ou pnpm localmente.
+
+#### Requisitos
+
+* Docker Desktop
+* Docker Compose v2
+
+Verifique o Docker:
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Iniciar o Open Design
+
+1. Clone o repositório, vá para o diretório deploy e copie o modelo de ambiente:
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. Gere um token seguro:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Abra o `.env` no seu editor, encontre `OD_API_TOKEN=` e cole o token gerado.
+
+Em seguida, inicie o serviço:
+
+```bash
+docker compose up -d
+```
+
+Abra no seu navegador:
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### Comandos comuns
+
+```bash id="gl95kp"
+# Ver logs
+docker compose logs -f
+
+# Reiniciar contêineres
+docker compose restart
+
+# Parar contêineres
+docker compose down
+
+# Baixar a imagem mais recente
+docker compose pull
+docker compose up -d
+```
+
+Para configuração avançada do Docker e variáveis de ambiente, consulte [`QUICKSTART.pt-BR.md`](QUICKSTART.pt-BR.md).
+
 ### Executar a partir do código-fonte

 ```bash
--- a/README.ru.md
+++ b/README.ru.md
@ -317,6 +317,70 @@ DISCOVERY directives  (turn-1 form, turn-2 brand branch, TodoWrite, 5-dim critiq
 - **[open-design.ai](https://open-design.ai/)** — официальная страница загрузки
 - **[GitHub-релизы](https://github.com/nexu-io/open-design/releases)**

+### Запуск через Docker
+
+Запустите Open Design без установки Node.js или pnpm локально.
+
+#### Требования
+
+* Docker Desktop
+* Docker Compose v2
+
+Проверьте Docker:
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Запуск Open Design
+
+1. Клонируйте репозиторий, перейдите в каталог deploy и скопируйте шаблон окружения:
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. Сгенерируйте безопасный токен:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Откройте `.env` в редакторе, найдите `OD_API_TOKEN=` и вставьте сгенерированный токен.
+
+Затем запустите сервис:
+
+```bash
+docker compose up -d
+```
+
+Откройте в браузере:
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### Часто используемые команды
+
+```bash id="gl95kp"
+# Просмотр логов
+docker compose logs -f
+
+# Перезапуск контейнеров
+docker compose restart
+
+# Остановка контейнеров
+docker compose down
+
+# Загрузка последнего образа
+docker compose pull
+docker compose up -d
+```
+
+Дополнительную информацию о настройке Docker и переменных окружения см. в [`QUICKSTART.md`](QUICKSTART.md).
+
 ### Запуск из исходников

 ```bash
--- a/README.tr.md
+++ b/README.tr.md
@ -308,6 +308,70 @@ Open Design'ı denemenin en hızlı yolu prebuilt desktop app'tir; Node yok, pnp
 - **[open-design.ai](https://open-design.ai/)** — resmi indirme sayfası
 - **[GitHub releases](https://github.com/nexu-io/open-design/releases)**

+### Docker ile çalıştır
+
+Open Design'ı Node.js veya pnpm yüklemeden çalıştırın.
+
+#### Gereksinimler
+
+* Docker Desktop
+* Docker Compose v2
+
+Docker'ı doğrulayın:
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Open Design'ı başlatın
+
+1. Depoyu klonlayın, deploy dizinine gidin ve ortam şablonunu kopyalayın:
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. Güvenli bir token oluşturun:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. `.env` dosyasını düzenleyicide açın, `OD_API_TOKEN=` satırını bulun ve oluşturduğunuz token'ı yapıştırın.
+
+Ardından servisi başlatın:
+
+```bash
+docker compose up -d
+```
+
+Tarayıcınızda açın:
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### Sık kullanılan komutlar
+
+```bash id="gl95kp"
+# Günlükleri görüntüle
+docker compose logs -f
+
+# Konteynerları yeniden başlat
+docker compose restart
+
+# Konteynerları durdur
+docker compose down
+
+# En son imajı çek
+docker compose pull
+docker compose up -d
+```
+
+Gelişmiş Docker yapılandırması ve ortam değişkenleri için [`QUICKSTART.md`](QUICKSTART.md) bölümüne bakın.
+
 ### Kaynaktan çalıştır

 ```bash
--- a/README.uk.md
+++ b/README.uk.md
@ -317,6 +317,70 @@ DISCOVERY directives  (форма 1-го ходу, бранч бренду 2-г
 - **[open-design.ai](https://open-design.ai/)** — офіційна сторінка завантаження
 - **[GitHub релізи](https://github.com/nexu-io/open-design/releases)**

+### Запуск через Docker
+
+Запустіть Open Design без встановлення Node.js або pnpm локально.
+
+#### Вимоги
+
+* Docker Desktop
+* Docker Compose v2
+
+Перевірте Docker:
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### Запуск Open Design
+
+1. Клонуйте репозиторій, перейдіть до каталогу deploy і скопіюйте шаблон середовища:
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. Згенеруйте безпечний токен:
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. Відкрийте `.env` у редакторі, знайдіть `OD_API_TOKEN=` і вставте згенерований токен.
+
+Потім запустіть сервіс:
+
+```bash
+docker compose up -d
+```
+
+Відкрийте у браузері:
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### Поширені команди
+
+```bash id="gl95kp"
+# Перегляд логів
+docker compose logs -f
+
+# Перезапуск контейнерів
+docker compose restart
+
+# Зупинка контейнерів
+docker compose down
+
+# Завантаження останнього образу
+docker compose pull
+docker compose up -d
+```
+
+Докладніше про налаштування Docker та змінні середовища див. у [`QUICKSTART.md`](QUICKSTART.md).
+
 ### Запуск з вихідного коду

 ```bash
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@ -316,6 +316,70 @@ DISCOVERY 指令         （turn-1 表单、turn-2 品牌分支、TodoWrite、
 - **[open-design.ai](https://open-design.ai/)** —— 官方下载页
 - **[GitHub releases](https://github.com/nexu-io/open-design/releases)**

+### 用 Docker 运行
+
+无需在本机安装 Node.js 或 pnpm 即可运行 Open Design。
+
+#### 环境需求
+
+* Docker Desktop
+* Docker Compose v2
+
+验证 Docker：
+
+```bash id="70jv9o"
+docker compose version
+```
+
+#### 启动 Open Design
+
+1. 克隆仓库，进入 deploy 目录，复制环境配置模板：
+
+   ```bash
+   git clone https://github.com/nexu-io/open-design.git
+   cd open-design/deploy
+   cp .env.example .env
+   ```
+
+2. 生成安全令牌：
+
+   ```bash
+   openssl rand -hex 32
+   ```
+
+3. 用编辑器打开 `.env`，找到 `OD_API_TOKEN=`，将生成的令牌粘贴进去。
+
+然后启动服务：
+
+```bash
+docker compose up -d
+```
+
+在浏览器中打开：
+
+```text id="4s4xeh"
+http://localhost:7456
+```
+
+#### 常用命令
+
+```bash id="gl95kp"
+# 查看日志
+docker compose logs -f
+
+# 重启容器
+docker compose restart
+
+# 停止容器
+docker compose down
+
+# 拉取最新镜像
+docker compose pull
+docker compose up -d
+```
+
+更多 Docker 配置与环境变量请参阅 [`QUICKSTART.zh-CN.md`](QUICKSTART.zh-CN.md)。
+
 ### 从源码运行

 ```bash