Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
215 lines
6.9 KiB
Plaintext
215 lines
6.9 KiB
Plaintext
---
|
|
title: 1-Click w/ Docker Compose
|
|
image: /images/user-guide/objects/objects.png
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/objects/objects.png" alt="Header" />
|
|
</Frame>
|
|
|
|
<Warning>
|
|
Docker containers are for production hosting or self-hosting, for the contribution please check the [Local Setup](https://docs.twenty.com/l/hu/developers/local-setup).
|
|
</Warning>
|
|
|
|
## Áttekintés
|
|
|
|
Ez az útmutató lépésről lépésre ismerteti a Twenty alkalmazás telepítését és konfigurálását a Docker Compose használatával. The aim is to make the process straightforward and prevent common pitfalls that could break your setup.
|
|
|
|
**Fontos:** Csak a kifejezetten ebben az útmutatóban említett beállításokat módosítsa. Más konfigurációk módosítása problémákat okozhat.
|
|
|
|
See docs [Setup Environment Variables](https://docs.twenty.com/l/hu/developers/self-hosting/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.
|
|
|
|
## Rendszerkövetelmények
|
|
|
|
- RAM: Ellenőrizze, hogy a környezete legalább 2GB RAM-mal rendelkezik-e. Ha a memória nem elegendő, a folyamatok összeomolhatnak.
|
|
- Docker & Docker Compose: Make sure both are installed and up-to-date.
|
|
|
|
## 1. opció: Egyvonalas szkript
|
|
|
|
Telepítse a Twenty legújabb stabil verzióját egyetlen paranccsal:
|
|
|
|
```bash
|
|
bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
|
|
```
|
|
|
|
Egy adott verzió vagy ág telepítése:
|
|
|
|
```bash
|
|
VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
|
|
```
|
|
|
|
- Cserélje le x.y.z-t a kívánt verziószámra.
|
|
- Cserélje le branch-name-t arra az ágra, amelyet telepíteni szeretne.
|
|
|
|
## 2. opció: Kézi lépések
|
|
|
|
Kövesse ezeket a lépéseket a kézi telepítéshez.
|
|
|
|
### Step 1: Set Up the Environment File
|
|
|
|
1. **Create the .env File**
|
|
|
|
Copy the example environment file to a new .env file in your working directory:
|
|
|
|
```bash
|
|
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
|
|
```
|
|
|
|
2. **Titkos tokenek generálása**
|
|
|
|
Futtassa a következő parancsot egy egyedi véletlen karakterlánc generálásához:
|
|
|
|
```bash
|
|
openssl rand -base64 32
|
|
```
|
|
|
|
**Fontos:** Tartsa ezt az értéket titokban / ne ossza meg.
|
|
|
|
3. **Update the `.env`**
|
|
|
|
Replace the placeholder value in your .env file with the generated token:
|
|
|
|
```ini
|
|
APP_SECRET=first_random_string
|
|
```
|
|
|
|
4. **Set the Postgres Password**
|
|
|
|
Frissítse a `PG_DATABASE_PASSWORD` értéket a .env fájlban erős jelszóval különleges karakterek nélkül.
|
|
|
|
```ini
|
|
PG_DATABASE_PASSWORD=my_strong_password
|
|
```
|
|
|
|
### 2) lépés: Szerezze be a Docker Compose fájlt
|
|
|
|
Töltse le a `docker-compose.yml` fájlt a munkakönyvtárába:
|
|
|
|
```bash
|
|
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml
|
|
```
|
|
|
|
### 3. lépés: Alkalmazás elindítása
|
|
|
|
Start the Docker containers:
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
### 4. lépés: Alkalmazás elérése
|
|
|
|
If you host twentyCRM on your own computer, open your browser and navigate to [http://localhost:3000](http://localhost:3000).
|
|
|
|
Ha egy szerveren üzemelteti, ellenőrizze, hogy a szerver fut-e, és minden rendben van-e
|
|
|
|
```bash
|
|
curl http://localhost:3000
|
|
```
|
|
|
|
## Konfiguráció
|
|
|
|
### Tegye a Twenty külső hozzáférésűvé
|
|
|
|
Alapértelmezés szerint a Twenty a `localhost`-on fut a `3000` porton. Külső domain vagy IP cím eléréséhez konfigurálnia kell a `SERVER_URL`-t az `.env` fájlban.
|
|
|
|
#### `SERVER_URL` megértése
|
|
|
|
- **Protokoll:** Használja a `http` vagy `https`-t a beállításától függően.
|
|
- Használja a `http`-t, ha nem állított be SSL-t.
|
|
- Használja a `https`-t, ha SSL-t állított be.
|
|
- **Domain/IP:** Ez az a domain név vagy IP cím, ahol az alkalmazás elérhető.
|
|
- **Port:** Adja meg a portszámot, ha nem alapértelmezett portokat használ (`80` a `http`, `443` a `https` esetén).
|
|
|
|
### SSL követelmények
|
|
|
|
SSL (HTTPS) bizonyos böngészői funkciók zavartalan működéséhez szükséges. Miközben ezek a funkciók működhetnek helyi fejlesztés során (mivel a böngészők a localhost-ot másként kezelik), egy megfelelő SSL beállítás szükséges, ha a Twentyt rendszeres domainen szeretné üzemeltetni.
|
|
|
|
Például a vágólap API biztonságos kontextust igényelhet - egyes funkciók, mint például a másolás gombok az alkalmazásban, nem működhetnek HTTPS nélkül.
|
|
|
|
Erősen javasoljuk, hogy a Twentyt egy fordított proxy mögött SSL terminációval állítsa be a biztonság és funkcionalitás érdekében.
|
|
|
|
#### `SERVER_URL` konfigurálása
|
|
|
|
1. **Határozza meg a hozzáférési URL-t**
|
|
- **Fordított proxy nélkül (közvetlen hozzáférés):**
|
|
|
|
Ha közvetlenül fér hozzá az alkalmazáshoz fordított proxy nélkül:
|
|
|
|
```ini
|
|
SERVER_URL=http://your-domain-or-ip:3000
|
|
```
|
|
|
|
- **Fordított proxyval (standard portok):**
|
|
|
|
Ha fordított proxyval, mint az Nginx vagy Traefik és SSL-lel konfigurál:
|
|
|
|
```ini
|
|
SERVER_URL=https://your-domain-or-ip
|
|
```
|
|
|
|
- **Fordított proxyval (egyedi portok):**
|
|
|
|
Ha nem szabványos portokat használ:
|
|
|
|
```ini
|
|
SERVER_URL=https://your-domain-or-ip:custom-port
|
|
```
|
|
|
|
2. **Frissítse az `.env` fájlt**
|
|
|
|
Nyissa meg az `.env` fájlt, és frissítse a `SERVER_URL`-t:
|
|
|
|
```ini
|
|
SERVER_URL=http(s)://your-domain-or-ip:your-port
|
|
```
|
|
|
|
**Példák:**
|
|
|
|
- Közvetlen hozzáférés SSL nélkül:
|
|
```ini
|
|
SERVER_URL=http://123.45.67.89:3000
|
|
```
|
|
- Hozzáférés domainen keresztül SSL-lel:
|
|
```ini
|
|
SERVER_URL=https://mytwentyapp.com
|
|
```
|
|
|
|
3. **Az alkalmazás újraindítása**
|
|
|
|
A változások érvénybe lépéséhez indítsa újra a Docker konténereket:
|
|
|
|
```bash
|
|
docker compose down
|
|
docker compose up -d
|
|
```
|
|
|
|
#### Megfontolások
|
|
|
|
- **Fordított Proxy Konfiguráció:**
|
|
|
|
Győződjön meg róla, hogy a fordított proxy a kéréseket a megfelelő belső portra továbbítja (alapértelmezés szerint `3000`). Konfigurálja az SSL megszakítást és az esetleg szükséges fejléceket.
|
|
|
|
- **Tűzfal Beállításai:**
|
|
|
|
Nyissa meg a szükséges portokat a tűzfalán, hogy külső hozzáférést engedélyezzen.
|
|
|
|
- **Konzisztencia:**
|
|
|
|
A `SERVER_URL`-nek meg kell egyeznie azzal, ahogyan a felhasználók az alkalmazást elérik a böngészőjükben.
|
|
|
|
#### Tartósság
|
|
|
|
- **Data Volumes:**
|
|
|
|
The Docker Compose configuration uses volumes to persist data for the database and server storage.
|
|
|
|
- **Stateless Environments:**
|
|
|
|
Ha egy állapotmentes környezetbe telepít (pl. bizonyos felhőszolgáltatások), konfigurálja a külső tárolót az adatok megőrzésére.
|
|
|
|
## Hibakeresés
|
|
|
|
Ha bármilyen problémát tapasztalsz, nézd meg a [Hibaelhárítást](https://docs.twenty.com/l/hu/developers/self-hosting/troubleshooting) a megoldásokért.
|
|
|