mirror of
https://github.com/twentyhq/twenty
synced 2026-04-21 13:37:22 +00:00
e02c24bd3a
Created by Github action --------- Co-authored-by: Abdul Rahman <ar5438376@gmail.com> Co-authored-by: Crowdin Bot <support+bot@crowdin.com> Co-authored-by: github-actions <github-actions@twenty.com> Co-authored-by: Charles Bochet <charles@twenty.com>
251 lines
No EOL
13 KiB
Text
251 lines
No EOL
13 KiB
Text
---
|
||
title: Ρύθμιση
|
||
image: /images/user-guide/table-views/table.png
|
||
---
|
||
|
||
<Frame>
|
||
<img src="/images/user-guide/table-views/table.png" alt="Header" />
|
||
</Frame>
|
||
|
||
import OptionTable from '@site/src/theme/OptionTable'
|
||
|
||
# Διαχείριση Διαμόρφωσης
|
||
|
||
<Warning>
|
||
**First time installing?** Follow the [Docker Compose installation guide](https://docs.twenty.com/l/el/developers/self-hosting/docker-compose) to get Twenty running, then return here for configuration.
|
||
</Warning>
|
||
|
||
Το Twenty προσφέρει **δύο λειτουργίες διαμόρφωσης** για να ανταποκριθεί στις διαφορετικές ανάγκες εγκατάστασης:
|
||
|
||
**Πρόσβαση στον πίνακα διαχείρισης:** Μόνο χρήστες με διαχειριστικά δικαιώματα (`canAccessFullAdminPanel: true`) μπορούν να έχουν πρόσβαση στη διαμόρφωση.
|
||
|
||
## 1. Διαμόρφωση Πίνακα Διαχείρισης (Προεπιλογή)
|
||
|
||
```bash
|
||
IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
|
||
```
|
||
|
||
**Most configuration happens through the UI** after installation:
|
||
|
||
1. Πρόσβαση στο Twenty instance σας (συνήθως `http://localhost:3000`)
|
||
2. Μεταβείτε στις **Ρυθμίσεις / Πίνακας Διαχείρισης / Μεταβλητές Διαμόρφωσης**
|
||
3. Διαμορφώστε ενοποιήσεις, email, αποθηκευτικό χώρο και άλλα
|
||
4. Οι αλλαγές ισχύουν άμεσα (εντός 15 δευτερολέπτων για πολυδοχεία)
|
||
|
||
<Warning>
|
||
**Multi-Container Deployments:** When using database configuration (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), both server and worker containers read from the same database. Οι αλλαγές στον πίνακα διαχείρισης επηρεάζουν και τα δύο αυτόματα, καταργώντας την ανάγκη να αντιγράψετε τις μεταβλητές περιβάλλοντος μεταξύ των κοντέινερ. (μόνο για μεταβλητές υποδομής).
|
||
</Warning>
|
||
|
||
**Τι μπορείτε να διαμορφώσετε μέσω του πίνακα διαχείρισης:**
|
||
|
||
- **Επαλήθευση** - Google/Microsoft OAuth, ρυθμίσεις κωδικού πρόσβασης
|
||
- **Email** - Ρυθμίσεις SMTP, πρότυπα, επαλήθευση
|
||
- **Αποθήκευση** - Διαμόρφωση S3, τοπικές διαδρομές αποθήκευσης
|
||
- **Ενοποιήσεις** - Gmail, Ημερολόγιο Google, Υπηρεσίες Microsoft
|
||
- **Workflow & Rate Limiting** - Execution limits, API throttling
|
||
- **Και πολλά άλλα...**
|
||
|
||
|
||
|
||
<Warning>
|
||
Κάθε μεταβλητή τεκμηριώνεται με περιγραφές στον πίνακα διαχείρισής σας στο **Ρυθμίσεις → Πίνακας Διαχείρισης → Μεταβλητές Διαμόρφωσης**.
|
||
Ορισμένες ρυθμίσεις υποδομής όπως συνδέσεις βάσης δεδομένων (`PG_DATABASE_URL`), διευθύνσεις διακομιστών (`SERVER_URL`) και μυστικά εφαρμογά (`APP_SECRET`) μπορούν να ρυθμιστούν μόνο μέσω αρχείου `.env`.
|
||
|
||
[Complete technical reference →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts) </Warning>
|
||
|
||
## 2. Ρύθμιση Μόνο Περιβάλλοντος
|
||
|
||
```bash
|
||
IS_CONFIG_VARIABLES_IN_DB_ENABLED=false
|
||
```
|
||
|
||
**All configuration managed through `.env` files:**
|
||
|
||
1. Ορίστε `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false` στο αρχείο `.env` σας
|
||
2. Προσθέστε όλες τις μεταβλητές ρύθμισης στο αρχείο `.env` σας
|
||
3. Επανεκκινήστε τα containers για να ισχύσουν οι αλλαγές
|
||
4. Ο πίνακας διαχείρισης θα εμφανίζει τις τρέχουσες τιμές, αλλά δεν μπορεί να τις τροποποιήσει
|
||
|
||
## Ενοποίηση Gmail & Ημερολόγιο Google
|
||
|
||
### Δημιουργήστε Έργο στο Google Cloud
|
||
|
||
1. Μεταβείτε στο [Κονσόλα Google Cloud](https://console.cloud.google.com/)
|
||
2. Δημιουργήστε ένα νέο έργο ή επιλέξτε υπάρχον
|
||
3. Ενεργοποιήστε αυτές τις APIs:
|
||
|
||
- [Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com)
|
||
- [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com)
|
||
- [People API](https://console.cloud.google.com/apis/library/people.googleapis.com)
|
||
|
||
### Διαμόρφωση OAuth
|
||
|
||
1. Μεταβείτε στις [Πιστοποιήσεις](https://console.cloud.google.com/apis/credentials)
|
||
2. Δημιουργήστε OAuth 2.0 Client ID
|
||
3. Προσθέστε αυτές τις ανακατευθύνσεις URIs:
|
||
- `https://{your-domain}/auth/google/redirect` (for SSO)
|
||
- `https://{your-domain}/auth/google-apis/get-access-token` (for integrations)
|
||
|
||
### Διαμόρφωση στο Twenty
|
||
|
||
1. Μεταβείτε στις **Ρυθμίσεις → Πίνακας Διαχείρισης → Μεταβλητές Διαμόρφωσης**
|
||
2. Βρείτε την ενότητα **Google Auth**
|
||
3. Ορίστε αυτές τις μεταβλητές:
|
||
- `MESSAGING_PROVIDER_GMAIL_ENABLED=true`
|
||
- `CALENDAR_PROVIDER_GOOGLE_ENABLED=true`
|
||
- `AUTH_GOOGLE_CLIENT_ID={client-id}`
|
||
- `AUTH_GOOGLE_CLIENT_SECRET={client-secret}`
|
||
- `AUTH_GOOGLE_CALLBACK_URL=https://{your-domain}/auth/google/redirect`
|
||
- `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token`
|
||
|
||
<Warning>
|
||
**Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
|
||
</Warning>
|
||
|
||
**Required scopes** (automatically configured):
|
||
[See relevant source code](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-google-apis-oauth-scopes.ts#L4-L10)
|
||
|
||
- `https://www.googleapis.com/auth/calendar.events`
|
||
- `https://www.googleapis.com/auth/gmail.readonly`
|
||
- `https://www.googleapis.com/auth/profile.emails.read`
|
||
|
||
### Αν η εφαρμογή σας είναι σε δοκιμαστική λειτουργία
|
||
|
||
Αν η εφαρμογή σας είναι σε δοκιμαστική λειτουργία, θα χρειαστεί να προσθέσετε δοκιμαστικούς χρήστες στο έργο σας.
|
||
|
||
Στην [οθόνη συγκατάθεσης OAuth](https://console.cloud.google.com/apis/credentials/consent), προσθέστε τους δοκιμαστικούς χρήστες στην ενότητα "Δοκιμαστικοί Χρήστες".
|
||
|
||
## Ενοποίηση Microsoft 365
|
||
|
||
<Warning>
|
||
Οι χρήστες πρέπει να διαθέτουν άδεια χρήσης [Microsoft 365 License](https://admin.microsoft.com/Adminportal/Home) για να μπορούν να χρησιμοποιούν το API Ημερολογίου και Μηνυμάτων. Δεν θα μπορούν να συγχρονίσουν τον λογαριασμό στο Twenty χωρίς αυτήν.
|
||
</Warning>
|
||
|
||
### Δημιουργήστε ένα έργο στο Microsoft Azure
|
||
|
||
Θα χρειαστεί να δημιουργήσετε ένα έργο στο [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) και να λάβετε τα διαπιστευτήρια.
|
||
|
||
### Ενεργοποιήστε APIs
|
||
|
||
Στην Κονσόλα Microsoft Azure ενεργοποιήστε τις ακόλουθες APIs στα "Δικαιώματα":
|
||
|
||
- Microsoft Graph: Mail.ReadWrite
|
||
- Microsoft Graph: Mail.Send
|
||
- Microsoft Graph: Calendars.Read
|
||
- Microsoft Graph: User.Read
|
||
- Microsoft Graph: openid
|
||
- Microsoft Graph: email
|
||
- Microsoft Graph: profile
|
||
- Microsoft Graph: offline_access
|
||
|
||
Note: "Mail.ReadWrite" and "Mail.Send" are only mandatory if you want to send emails using our workflow actions. Μπορείτε να χρησιμοποιήσετε "Mail.Read" αν μόνο θέλετε να λαμβάνετε email.
|
||
|
||
### Εξουσιοδοτημένες διευθύνσεις ανακατεύθυνσης URIs
|
||
|
||
Πρέπει να προσθέσετε τις ακόλουθες διευθύνσεις ανακατεύθυνσης URIs στο έργο σας:
|
||
|
||
- `https://{your-domain}/auth/microsoft/redirect` if you want to use Microsoft SSO
|
||
- `https://{your-domain}/auth/microsoft-apis/get-access-token`
|
||
|
||
### Διαμόρφωση στο Twenty
|
||
|
||
1. Μεταβείτε στις **Ρυθμίσεις → Πίνακας Διαχείρισης → Μεταβλητές Διαμόρφωσης**
|
||
2. Βρείτε την ενότητα **Microsoft Auth**
|
||
3. Ορίστε αυτές τις μεταβλητές:
|
||
- `MESSAGING_PROVIDER_MICROSOFT_ENABLED=true`
|
||
- `CALENDAR_PROVIDER_MICROSOFT_ENABLED=true`
|
||
- `AUTH_MICROSOFT_ENABLED=true`
|
||
- `AUTH_MICROSOFT_CLIENT_ID={client-id}`
|
||
- `AUTH_MICROSOFT_CLIENT_SECRET={client-secret}`
|
||
- `AUTH_MICROSOFT_CALLBACK_URL=https://{your-domain}/auth/microsoft/redirect`
|
||
- `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token`
|
||
|
||
<Warning>
|
||
**Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
|
||
</Warning>
|
||
|
||
### Configure scopes
|
||
|
||
[See relevant source code](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-microsoft-apis-oauth-scopes.ts#L2-L9)
|
||
|
||
- 'openid'
|
||
- 'ηλεκτρονικό ταχυδρομείο'
|
||
- 'προφίλ'
|
||
- 'offline_access'
|
||
- 'Mail.ReadWrite'
|
||
- 'Mail.Send'
|
||
- 'Calendars.Read'
|
||
|
||
### Αν η εφαρμογή σας είναι σε δοκιμαστική λειτουργία
|
||
|
||
Αν η εφαρμογή σας είναι σε δοκιμαστική λειτουργία, θα χρειαστεί να προσθέσετε δοκιμαστικούς χρήστες στο έργο σας.
|
||
|
||
Προσθέστε τους δοκιμαστικούς χρήστες στην ενότητα "Χρήστες και ομάδες".
|
||
|
||
## Background Jobs for Calendar & Messaging
|
||
|
||
After configuring Gmail, Google Calendar, or Microsoft 365 integrations, you need to start the background jobs that sync data.
|
||
|
||
Καταχωρήστε τις ακόλουθες επαναλαμβανόμενες εργασίες στο container εργατών σας:
|
||
|
||
```bash
|
||
# from your worker container
|
||
yarn command:prod cron:messaging:messages-import
|
||
yarn command:prod cron:messaging:message-list-fetch
|
||
yarn command:prod cron:calendar:calendar-event-list-fetch
|
||
yarn command:prod cron:calendar:calendar-events-import
|
||
yarn command:prod cron:messaging:ongoing-stale
|
||
yarn command:prod cron:calendar:ongoing-stale
|
||
yarn command:prod cron:workflow:automated-cron-trigger
|
||
```
|
||
|
||
## Ρύθμιση Email
|
||
|
||
1. Μεταβείτε στις **Ρυθμίσεις → Πίνακας Διαχείρισης → Μεταβλητές Διαμόρφωσης**
|
||
2. Βρείτε την ενότητα **Email**
|
||
3. Διαμορφώστε τις ρυθμίσεις SMTP σας:
|
||
|
||
<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">
|
||
|
||
<ArticleTab>
|
||
|
||
Θα χρειαστεί να προμηθεύσετε έναν [Κωδικό Εφαρμογής](https://support.google.com/accounts/answer/185833).
|
||
|
||
- EMAIL_DRIVER=smtp
|
||
- EMAIL_SMTP_HOST=smtp.gmail.com
|
||
- EMAIL_SMTP_PORT=465
|
||
- EMAIL_SMTP_USER=gmail_email_address
|
||
- EMAIL_SMTP_PASSWORD='gmail_app_password'
|
||
|
||
</ArticleTab>
|
||
|
||
<ArticleTab>
|
||
|
||
**smtp4dev** είναι ένας ψεύτικος διακομιστής SMTP email για την ανάπτυξη και τη δοκιμή.
|
||
|
||
- EMAIL_DRIVER=smtp
|
||
- EMAIL_SMTP_HOST=smtp.office365.com
|
||
- EMAIL_SMTP_PORT=587
|
||
- EMAIL_SMTP_USER=office365_email_address
|
||
- EMAIL_SMTP_PASSWORD='office365_password'
|
||
|
||
</ArticleTab>
|
||
|
||
<ArticleTab>
|
||
|
||
**smtp4dev** είναι ένας ψεύτικος διακομιστής SMTP email για την ανάπτυξη και τη δοκιμή.
|
||
|
||
- Εκτελέστε την εικόνα smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
|
||
- Πρόσβαση στο smtp4dev ui εδώ: [http://localhost:8090](http://localhost:8090)
|
||
- Ορίστε τις ακόλουθες μεταβλητές:
|
||
- EMAIL_DRIVER=smtp
|
||
- EMAIL_SMTP_HOST=localhost
|
||
- EMAIL_SMTP_PORT=2525
|
||
|
||
</ArticleTab>
|
||
|
||
</ArticleTabs>
|
||
|
||
<Warning>
|
||
**Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
|
||
</Warning> |