Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
215 lines
6.7 KiB
Plaintext
215 lines
6.7 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/fi/developers/local-setup).
|
|
</Warning>
|
|
|
|
## Yleiskatsaus
|
|
|
|
Tämä opas tarjoaa vaiheittaiset ohjeet, kuinka asentaa ja määrittää Twenty-sovellus käyttämällä Docker Composea. Tavoitteena on tehdä prosessista yksinkertainen ja välttää yleisiä sudenkuoppia, jotka voivat rikkoa asennuksen.
|
|
|
|
**Tärkeää:** Muuta vain asetuksia, jotka on erikseen mainittu tässä oppaassa. Altering other configurations may lead to issues.
|
|
|
|
See docs [Setup Environment Variables](https://docs.twenty.com/l/fi/developers/self-hosting/setup) for advanced configuration. Kaikki ympäristömuuttujat on määritettävä docker-compose.yml-tiedostossa palvelin- ja/tai työntekijätasolla muuttujasta riippuen.
|
|
|
|
## Järjestelmävaatimukset
|
|
|
|
- RAM: Varmista, että ympäristössäsi on vähintään 2GB RAM-muistia. Riittämätön muisti voi aiheuttaa prosessien kaatumisen.
|
|
- Docker & Docker Compose: Varmista, että molemmat ovat asennettuina ja ajan tasalla.
|
|
|
|
## Vaihtoehto 1: Yhden rivin skripti
|
|
|
|
Install the latest stable version of Twenty with a single command:
|
|
|
|
```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)
|
|
```
|
|
|
|
- Korvaa x.y.z haluamallasi versionumerolla.
|
|
- Replace branch-name with the name of the branch you want to install.
|
|
|
|
## Vaihtoehto 2: Manuaaliset askeleet
|
|
|
|
Noudata näitä ohjeita manuaalista asennusta varten.
|
|
|
|
### Step 1: Set Up the Environment File
|
|
|
|
1. **Luo .env-tiedosto**
|
|
|
|
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. **Luo salaiset tokenit**
|
|
|
|
Suorita seuraava komento luodaksesi ainutlaatuisen satunnaismerkkijonon:
|
|
|
|
```bash
|
|
openssl rand -base64 32
|
|
```
|
|
|
|
**Tärkeää:** Pidä tämä arvo salassa / älä jaa sitä.
|
|
|
|
3. **Päivitä `.env`**
|
|
|
|
Korvaa paikkamerkkiarvo .env-tiedostossasi generoidulla tokenilla:
|
|
|
|
```ini
|
|
APP_SECRET=first_random_string
|
|
```
|
|
|
|
4. **Aseta Postgres-salasana**
|
|
|
|
Update the `PG_DATABASE_PASSWORD` value in the .env file with a strong password without special characters.
|
|
|
|
```ini
|
|
PG_DATABASE_PASSWORD=my_strong_password
|
|
```
|
|
|
|
### Step 2: Obtain the Docker Compose File
|
|
|
|
Lataa `docker-compose.yml` tiedosto työhakemistoosi:
|
|
|
|
```bash
|
|
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml
|
|
```
|
|
|
|
### Askel 3: Suorita Sovellus
|
|
|
|
Start the Docker containers:
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
### Step 4: Access the Application
|
|
|
|
Jos isännöit twentyCRM:ää omalla tietokoneellasi, avaa selaimesi ja siirry osoitteeseen [http://localhost:3000](http://localhost:3000).
|
|
|
|
Jos isännöit palvelimella, tarkista että palvelimesi on toiminnassa ja että kaikki on ok
|
|
|
|
```bash
|
|
curl http://localhost:3000
|
|
```
|
|
|
|
## Kokoonpano
|
|
|
|
### Avaa Twenty ulkoiseen käyttöön
|
|
|
|
Oletuksena, Twenty toimii `localhost` portissa `3000`. Päästäksesi siihen ulkoisen domainin tai IP-osoitteen kautta, sinun tulee konfiguroida `SERVER_URL` `.env` tiedostossasi.
|
|
|
|
#### `SERVER_URL`:n Ymmärtäminen
|
|
|
|
- **Protokolla:** Käytä `http` tai `https` asetuksistasi riippuen.
|
|
- Use `http` if you haven't set up SSL.
|
|
- Käytä `https` jos sinulla on SSL asennettuna.
|
|
- **Domain/IP:** Tämä on domain-nimi tai IP-osoite, jossa sovelluksesi on saavutettavissa.
|
|
- **Port:** Include the port number if you're not using the default ports (`80` for `http`, `443` for `https`).
|
|
|
|
### SSL-vaatimukset
|
|
|
|
SSL (HTTPS) vaaditaan tiettyjen selaintoimintojen toimimiseksi oikein. Vaikka nämä toiminnot saattavat toimia paikallisessa kehityksessä (koska selaimet käsittelevät localhostia eri tavalla), oikea SSL-asetus vaaditaan, kun isännöit Twentyä normaalilla domainilla.
|
|
|
|
Esimerkiksi leikepöytä-API saattaa vaatia turvallisen yhteyden - jotkut toiminnot, kuten kopiointipainikkeet koko sovelluksessa, eivät välttämättä toimi ilman HTTPS:ää.
|
|
|
|
Suosittelemme vahvasti sijoittamaan Twentyn SSL-terminaalin taakse optimaalisen turvallisuuden ja toimivuuden varmistamiseksi.
|
|
|
|
#### `SERVER_URL`:n Määrittäminen
|
|
|
|
1. **Määritä Pääsyosoitteesi**
|
|
- **Ilman Käänteistä Välityspalvelinta (Suora Yhteys):**
|
|
|
|
Jos käytät sovellusta ilman käänteistä välityspalvelinta:
|
|
|
|
```ini
|
|
SERVER_URL=http://your-domain-or-ip:3000
|
|
```
|
|
|
|
- **Käänteisellä Välityspalvelimella (Vakioliitäntä):**
|
|
|
|
Jos käytät käänteistä välityspalvelinta, kuten Nginx tai Traefik, ja sinulla on SSL asennettuna:
|
|
|
|
```ini
|
|
SERVER_URL=https://your-domain-or-ip
|
|
```
|
|
|
|
- **Käänteisellä Välityspalvelimella (Mukautetut Portit):**
|
|
|
|
Jos käytät ei-standardeja portteja:
|
|
|
|
```ini
|
|
SERVER_URL=https://your-domain-or-ip:custom-port
|
|
```
|
|
|
|
2. **Päivitä `.env` Tiedosto**
|
|
|
|
Avaa `.env` tiedostosi ja päivitä `SERVER_URL`:
|
|
|
|
```ini
|
|
SERVER_URL=http(s)://your-domain-or-ip:your-port
|
|
```
|
|
|
|
**Esimerkkejä:**
|
|
|
|
- Suora pääsy ilman SSL:ää:
|
|
```ini
|
|
SERVER_URL=http://123.45.67.89:3000
|
|
```
|
|
- Pääsy domainin kautta SSL:llä:
|
|
```ini
|
|
SERVER_URL=https://mytwentyapp.com
|
|
```
|
|
|
|
3. **Käynnistä Sovellus Uudelleen**
|
|
|
|
Jotta muutokset tulevat voimaan, käynnistä Docker-kontit uudelleen:
|
|
|
|
```bash
|
|
docker compose down
|
|
docker compose up -d
|
|
```
|
|
|
|
#### Huomioitavia seikkoja
|
|
|
|
- **Käänteisen välityspalvelimen konfigurointi:**
|
|
|
|
Varmista, että käänteinen välityspalvelimesi välittää pyynnöt oikealle sisäiselle portille (`3000` oletuksena). Konfiguroi SSL-lopetus ja tarvittavat otsikot.
|
|
|
|
- **Palomuurin asetukset:**
|
|
|
|
Avaa tarvittavat portit palomuurissasi ulkoisen pääsyn mahdollistamiseksi.
|
|
|
|
- **Johdonmukaisuus:**
|
|
|
|
`SERVER_URL`:in on vastattava sitä, miten käyttäjät käyttävät sovellustasi selaimillaan.
|
|
|
|
#### Pysyvyys
|
|
|
|
- **Datavolyymit:**
|
|
|
|
The Docker Compose configuration uses volumes to persist data for the database and server storage.
|
|
|
|
- **Tilattomat ympäristöt:**
|
|
|
|
Jos käytössä on tilaton ympäristö (esim. tietyt pilvipalvelut), konfiguroi ulkoinen tallennustila tietojen säilyvyyden varmistamiseksi.
|
|
|
|
## Vianmääritys
|
|
|
|
Jos kohtaat ongelmia, tarkista [Vianmääritys](https://docs.twenty.com/l/fi/developers/self-hosting/troubleshooting) ratkaisujen saamiseksi.
|
|
|