i18n - docs translations (#17434)
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
2353bc62cc
commit
e0d4492013
@@ -1,253 +1,253 @@
|
||||
---
|
||||
title: 1-Click w/ Docker Compose
|
||||
title: 1-クリック w/ Docker Compose
|
||||
---
|
||||
|
||||
<Warning>
|
||||
Docker containers are for production hosting or self-hosting, for the contribution please check the [Local Setup](/l/ja/developers/contribute/capabilities/local-setup).
|
||||
Dockerコンテナは本番ホスティングまたはセルフホスティング用です。貢献するには、[ローカルセットアップ](/l/ja/developers/contribute/capabilities/local-setup)を確認してください。
|
||||
</Warning>
|
||||
|
||||
## Overview
|
||||
## 概要
|
||||
|
||||
This guide provides step-by-step instructions to install and configure the Twenty application using Docker Compose. The aim is to make the process straightforward and prevent common pitfalls that could break your setup.
|
||||
このガイドは、Docker Composeを使用してTwentyアプリケーションをインストールおよび構成するためのステップバイステップの手順を提供します。 プロセスを簡単にし、設定を破壊する可能性のある一般的な落とし穴を防止することが目的です。 プロセスを簡単にし、設定を破壊する可能性のある一般的な落とし穴を防止することが目的です。 プロセスを簡単にし、設定を破壊する可能性のある一般的な落とし穴を防止することが目的です。 プロセスを簡単にし、設定を破壊する可能性のある一般的な落とし穴を防止することが目的です。
|
||||
|
||||
**Important:** Only modify settings explicitly mentioned in this guide. Altering other configurations may lead to issues.
|
||||
**重要:** このガイドで明示的に言及されている設定のみを変更してください。 他の構成を変更すると、問題が発生する可能性があります。 他の構成を変更すると、問題が発生する可能性があります。 他の構成を変更すると、問題が発生する可能性があります。
|
||||
|
||||
See docs [Setup Environment Variables](/l/ja/developers/self-host/capabilities/setup) for advanced configuration. All environment variables must be declared in the docker-compose.yml file at the server and / or worker level depending on the variable.
|
||||
高度な構成については、[環境変数の設定](/l/ja/developers/self-host/capabilities/setup)を参照してください。 高度な構成については、[環境変数の設定](https://docs.twenty.com/l/ja/developers/self-hosting/setup)を参照してください。 高度な構成については、[環境変数の設定](https://docs.twenty.com/l/ja/developers/self-hosting/setup)を参照してください。 すべての環境変数は、サーバーレベルまたはワーカーレベルでdocker-compose.ymlファイルに宣言する必要があります。
|
||||
|
||||
## System Requirements
|
||||
## システム要件
|
||||
|
||||
* RAM: Ensure your environment has at least 2GB of RAM. Insufficient memory can cause processes to crash.
|
||||
* Docker & Docker Compose: Make sure both are installed and up-to-date.
|
||||
* RAM: 環境に最低2GBのRAMがあることを確認してください。 メモリが不足するとプロセスがクラッシュすることがあります。 メモリが不足するとプロセスがクラッシュすることがあります。 メモリが不足するとプロセスがクラッシュすることがあります。 メモリが不足するとプロセスがクラッシュすることがあります。 メモリが不足するとプロセスがクラッシュすることがあります。 メモリが不足するとプロセスがクラッシュすることがあります。 メモリが不足するとプロセスがクラッシュすることがあります。
|
||||
* Docker & Docker Compose: 両方がインストールされ、最新であることを確認してください。
|
||||
|
||||
## Option 1: One-line script
|
||||
## オプション 1: ワンラインスクリプト
|
||||
|
||||
Install the latest stable version of Twenty with a single command:
|
||||
単一のコマンドで最新版のTwentyをインストールします:
|
||||
|
||||
```bash
|
||||
bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
|
||||
```
|
||||
|
||||
To install a specific version or branch:
|
||||
特定のバージョンまたはブランチをインストールするには:
|
||||
|
||||
```bash
|
||||
VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
|
||||
```
|
||||
|
||||
* Replace x.y.z with the desired version number.
|
||||
* Replace branch-name with the name of the branch you want to install.
|
||||
* x.y.zを希望するバージョン番号に置き換えます。
|
||||
* branch-nameをインストールしたいブランチの名前に置き換えます。
|
||||
|
||||
## Option 2: Manual steps
|
||||
## オプション 2: 手動の手順
|
||||
|
||||
Follow these steps for a manual setup.
|
||||
マニュアルセットアップには、これらの手順に従ってください。
|
||||
|
||||
### Step 1: Set Up the Environment File
|
||||
### ステップ 1: 環境ファイルを設定
|
||||
|
||||
1. **Create the .env File**
|
||||
1. **.env ファイルを作成**
|
||||
|
||||
Copy the example environment file to a new .env file in your working directory:
|
||||
例の環境ファイルを作業ディレクトリに新しい.envファイルとしてコピーします:
|
||||
|
||||
```bash
|
||||
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
|
||||
```
|
||||
|
||||
2. **Generate Secret Tokens**
|
||||
2. **シークレットトークンを生成**
|
||||
|
||||
Run the following command to generate a unique random string:
|
||||
ユニークなランダム文字列を生成するには、次のコマンドを実行します:
|
||||
|
||||
```bash
|
||||
openssl rand -base64 32
|
||||
```
|
||||
|
||||
**Important:** Keep this value secret / do not share it.
|
||||
**重要:** この値を秘密にしてください/共有しないでください。
|
||||
|
||||
3. **Update the `.env`**
|
||||
3. **`.env`を更新**
|
||||
|
||||
Replace the placeholder value in your .env file with the generated token:
|
||||
生成したトークンで.envファイルのプレースホルダー値を置き換えます:
|
||||
|
||||
```ini
|
||||
APP_SECRET=first_random_string
|
||||
```
|
||||
|
||||
4. **Set the Postgres Password**
|
||||
4. **Postgres パスワードを設定**
|
||||
|
||||
Update the `PG_DATABASE_PASSWORD` value in the .env file with a strong password without special characters.
|
||||
特殊文字を含まない強力なパスワードで、.envファイルの`PG_DATABASE_PASSWORD`値を更新します。
|
||||
|
||||
```ini
|
||||
PG_DATABASE_PASSWORD=my_strong_password
|
||||
```
|
||||
|
||||
### Step 2: Obtain the Docker Compose File
|
||||
### ステップ 2: Docker Compose ファイルを取得
|
||||
|
||||
Download the `docker-compose.yml` file to your working directory:
|
||||
作業ディレクトリに`docker-compose.yml`ファイルをダウンロードします:
|
||||
|
||||
```bash
|
||||
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml
|
||||
```
|
||||
|
||||
### Step 3: Launch the Application
|
||||
### ステップ 3: アプリケーションを起動
|
||||
|
||||
Start the Docker containers:
|
||||
Dockerコンテナを開始します:
|
||||
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### Step 4: Access the Application
|
||||
### ステップ 4: アプリケーションにアクセス
|
||||
|
||||
If you host twentyCRM on your own computer, open your browser and navigate to [http://localhost:3000](http://localhost:3000).
|
||||
自分のコンピュータでtwentyCRMをホストしている場合は、ブラウザを開いて[http://localhost:3000](http://localhost:3000)にアクセスします。
|
||||
|
||||
If you host it on a server, check that the server is running and that everything is ok with
|
||||
サーバーでホストしている場合、サーバーが稼働していてすべてが正常であるかを確認してください
|
||||
|
||||
```bash
|
||||
curl http://localhost:3000
|
||||
```
|
||||
|
||||
## Configuration
|
||||
## 構成
|
||||
|
||||
### Expose Twenty to External Access
|
||||
### Twentyを外部アクセスに公開
|
||||
|
||||
By default, Twenty runs on `localhost` at port `3000`. To access it via an external domain or IP address, you need to configure the `SERVER_URL` in your `.env` file.
|
||||
デフォルトでは、Twentyはポート`3000`で`localhost`上で動作します。 外部ドメインまたはIPアドレス経由でアクセスするには、`.env`ファイルで`SERVER_URL`を構成する必要があります。 外部ドメインまたはIPアドレス経由でアクセスするには、`.env`ファイルで`SERVER_URL`を構成する必要があります。
|
||||
|
||||
#### Understanding `SERVER_URL`
|
||||
#### `SERVER_URL`の理解
|
||||
|
||||
* **Protocol:** Use `http` or `https` depending on your setup.
|
||||
* Use `http` if you haven't set up SSL.
|
||||
* Use `https` if you have SSL configured.
|
||||
* **Domain/IP:** This is the domain name or IP address where your application is accessible.
|
||||
* **Port:** Include the port number if you're not using the default ports (`80` for `http`, `443` for `https`).
|
||||
* **プロトコル:** 設定に応じて`http`または`https`を使用します。
|
||||
* SSLを設定していない場合は`http`を使用します。
|
||||
* SSLを構成済みの場合は`https`を使用します。
|
||||
* **ドメイン/IP:** これは、アプリケーションがアクセス可能なドメイン名またはIPアドレスです。
|
||||
* **ポート:** デフォルトのポート（`http`は`80`、`https`は`443`）以外を使用している場合、ポート番号を含めます。
|
||||
|
||||
### SSL Requirements
|
||||
### SSL 要件
|
||||
|
||||
SSL (HTTPS) is required for certain browser features to work properly. While these features might work during local development (as browsers treat localhost differently), a proper SSL setup is needed when hosting Twenty on a regular domain.
|
||||
SSL（HTTPS）は、特定のブラウザ機能が正しく動作するために必要です。 SSL（HTTPS）は、特定のブラウザ機能が正しく動作するために必要です。 SSL（HTTPS）は、特定のブラウザ機能が正しく動作するために必要です。 これらの機能は、ローカル開発中に動作するかもしれませんが（ブラウザがlocalhostを異なる扱い方をするため）、Twentyを通常のドメインでホスティングする場合、適切なSSLの設定が必要です。
|
||||
|
||||
For example, the clipboard API might require a secure context - some features like copy buttons throughout the application might not work without HTTPS enabled.
|
||||
たとえば、クリップボードAPIは安全なコンテキストが必要かもしれません - アプリケーション全体でのコピー ボタンのような機能は、HTTPSが有効でないと動作しないかもしれません。
|
||||
|
||||
We strongly recommend setting up Twenty behind a reverse proxy with SSL termination for optimal security and functionality.
|
||||
最適なセキュリティと機能のために、SSL終了を備えたリバースプロキシの背後にTwentyを設定することを強くお勧めします。
|
||||
|
||||
#### Configuring `SERVER_URL`
|
||||
#### `SERVER_URL`の構成
|
||||
|
||||
1. **Determine Your Access URL**
|
||||
* **Without Reverse Proxy (Direct Access):**
|
||||
1. **アクセスURLを特定する**
|
||||
* **リバースプロキシがない場合（直接アクセス）:**
|
||||
|
||||
If you're accessing the application directly without a reverse proxy:
|
||||
リバースプロキシなしでアプリケーションに直接アクセスする場合:
|
||||
|
||||
```ini
|
||||
SERVER_URL=http://your-domain-or-ip:3000
|
||||
```
|
||||
|
||||
* **With Reverse Proxy (Standard Ports):**
|
||||
* **リバースプロキシを使用する場合（標準ポート）:**
|
||||
|
||||
If you're using a reverse proxy like Nginx or Traefik and have SSL configured:
|
||||
NginxやTraefikのようなリバースプロキシを使用し、SSLを構成している場合:
|
||||
|
||||
```ini
|
||||
SERVER_URL=https://your-domain-or-ip
|
||||
```
|
||||
|
||||
* **With Reverse Proxy (Custom Ports):**
|
||||
* **リバースプロキシを使用する場合（カスタムポート）:**
|
||||
|
||||
If you're using non-standard ports:
|
||||
標準以外のポートを使用している場合:
|
||||
|
||||
```ini
|
||||
SERVER_URL=https://your-domain-or-ip:custom-port
|
||||
```
|
||||
|
||||
2. **Update the `.env` File**
|
||||
2. **.env ファイルを更新**
|
||||
|
||||
Open your `.env` file and update the `SERVER_URL`:
|
||||
.env`ファイルを開き、`SERVER_URL\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\`を更新します:
|
||||
|
||||
```ini
|
||||
SERVER_URL=http(s)://your-domain-or-ip:your-port
|
||||
```
|
||||
|
||||
**Examples:**
|
||||
**例:**
|
||||
|
||||
* Direct access without SSL:
|
||||
* SSLなしの直接アクセス:
|
||||
```ini
|
||||
SERVER_URL=http://123.45.67.89:3000
|
||||
```
|
||||
* Access via domain with SSL:
|
||||
* ドメイン経由でSSLを使用してアクセス:
|
||||
```ini
|
||||
SERVER_URL=https://mytwentyapp.com
|
||||
```
|
||||
|
||||
3. **Restart the Application**
|
||||
3. **アプリケーションを再起動**
|
||||
|
||||
For changes to take effect, restart the Docker containers:
|
||||
変更を反映するために、Dockerコンテナを再起動します:
|
||||
|
||||
```bash
|
||||
docker compose down
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
#### Considerations
|
||||
#### 考慮事項
|
||||
|
||||
* **Reverse Proxy Configuration:**
|
||||
* **リバースプロキシ構成:**
|
||||
|
||||
Ensure your reverse proxy forwards requests to the correct internal port (`3000` by default). Configure SSL termination and any necessary headers.
|
||||
リバースプロキシが正しい内部ポート（デフォルトでは`3000`）にリクエストを転送することを確認してください。 SSL終端と必要なヘッダーを設定します。 SSL終端と必要なヘッダーを設定します。 SSL終端と必要なヘッダーを設定します。
|
||||
|
||||
* **Firewall Settings:**
|
||||
* **ファイアウォール設定:**
|
||||
|
||||
Open necessary ports in your firewall to allow external access.
|
||||
外部アクセスを許可するためにファイアウォールで必要なポートを開けます。
|
||||
|
||||
* **Consistency:**
|
||||
* **一貫性:**
|
||||
|
||||
The `SERVER_URL` must match how users access your application in their browsers.
|
||||
`SERVER_URL`は、ユーザーがブラウザでアプリケーションにアクセスする方法と一致する必要があります。
|
||||
|
||||
#### Persistence
|
||||
#### 永続性
|
||||
|
||||
* **Data Volumes:**
|
||||
* **データボリューム:**
|
||||
|
||||
The Docker Compose configuration uses volumes to persist data for the database and server storage.
|
||||
Docker Compose 構成では、データベースとサーバーストレージのデータを永続化するためにボリュームを使用します。
|
||||
|
||||
* **Stateless Environments:**
|
||||
* **ステートレス環境:**
|
||||
|
||||
If deploying to a stateless environment (e.g., certain cloud services), configure external storage to persist data.
|
||||
ステートレス環境（例: 一部のクラウドサービス）に展開する場合、データを永続化するために外部ストレージを設定します。
|
||||
|
||||
## Backup and Restore
|
||||
## バックアップと復元
|
||||
|
||||
Regular backups protect your CRM data from loss.
|
||||
定期的なバックアップは、CRM データを損失から保護します。
|
||||
|
||||
### Create a Database Backup
|
||||
### データベースのバックアップを作成
|
||||
|
||||
```bash
|
||||
docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql
|
||||
```
|
||||
|
||||
### Automate Daily Backups
|
||||
### 日次バックアップを自動化
|
||||
|
||||
Add to your crontab (`crontab -e`):
|
||||
crontab に追加 (`crontab -e`):
|
||||
|
||||
```bash
|
||||
0 2 * * * docker exec twenty-postgres pg_dump -U postgres twenty > /backups/twenty_$(date +\%Y\%m\%d).sql
|
||||
```
|
||||
|
||||
### Restore from Backup
|
||||
### バックアップから復元
|
||||
|
||||
1. Stop the application:
|
||||
1. アプリケーションを停止します:
|
||||
|
||||
```bash
|
||||
docker compose stop twenty-server twenty-front
|
||||
```
|
||||
|
||||
2. Restore the database:
|
||||
2. データベースを復元します:
|
||||
|
||||
```bash
|
||||
docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql
|
||||
```
|
||||
|
||||
3. Restart services:
|
||||
3. サービスの再起動:
|
||||
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### Backup Best Practices
|
||||
### バックアップのベストプラクティス
|
||||
|
||||
* **Test restores regularly** — verify backups actually work
|
||||
* **Store backups off-site** — use cloud storage (S3, GCS, etc.)
|
||||
* **Encrypt sensitive data** — protect backups with encryption
|
||||
* **Retain multiple copies** — keep daily, weekly, and monthly backups
|
||||
* **復元を定期的にテスト** — バックアップが実際に機能することを確認
|
||||
* **バックアップをオフサイトに保管** — クラウドストレージ (S3, GCS など) を使用
|
||||
* **機密データを暗号化** — バックアップを暗号化で保護
|
||||
* **複数のコピーを保持** — 日次・週次・月次のバックアップを保持
|
||||
|
||||
## Troubleshooting
|
||||
## トラブルシューティング
|
||||
|
||||
If you encounter any problem, check [Troubleshooting](/l/ja/developers/self-host/capabilities/troubleshooting) for solutions.
|
||||
問題が発生した場合は、[トラブルシューティング](/l/ja/developers/self-host/capabilities/troubleshooting)を確認して解決策を見つけてください。
|
||||
|
||||
Reference in New Issue
Block a user