Created by Github action --------- Co-authored-by: Crowdin Bot <support+bot@crowdin.com> Co-authored-by: github-actions <github-actions@twenty.com>
227 lines
9.5 KiB
Plaintext
227 lines
9.5 KiB
Plaintext
---
|
|
title: Problemen oplossen
|
|
image: /images/user-guide/what-is-twenty/20.png
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Problemen oplossen
|
|
|
|
Als u problemen tegenkomt bij het instellen van uw ontwikkelomgeving, het upgraden van uw instantie of zelfhosting,
|
|
hier zijn enkele oplossingen voor veelvoorkomende problemen.
|
|
|
|
### Zelf-hosting
|
|
|
|
#### Eerste installatie resulteert in `wachtwoordverificatie mislukt voor gebruiker "postgres"`
|
|
|
|
🚨 **BELANGRIJK: Deze oplossing is ALLEEN voor nieuwe installaties** 🚨
|
|
Als u een bestaande Twenty-instantie heeft met productiedata, gebruik deze stappen NIET, omdat deze permanent uw database verwijderen!
|
|
|
|
Tijdens de eerste installatie van Twenty wilt u misschien het standaarddatabasewachtwoord wijzigen.
|
|
Het wachtwoord dat u instelt tijdens de eerste installatie wordt permanent opgeslagen in de databasevolume. Als u later probeert dit wachtwoord in uw configuratie te wijzigen zonder het oude volume te verwijderen, krijgt u verificatiefouten omdat de database nog steeds het oorspronkelijke wachtwoord gebruikt.
|
|
|
|
⚠️ WAARSCHUWING: De volgende stappen zullen alle gegevens in de database PERMANENT VERWIJDEREN! ⚠️
|
|
Ga alleen verder als dit een nieuwe installatie is zonder belangrijke gegevens.
|
|
|
|
Om de `PG_DATABASE_PASSWORD` bij te werken, dient u:
|
|
|
|
```sh
|
|
# Update the PG_DATABASE_PASSWORD in .env
|
|
docker compose down --volumes
|
|
docker compose up -d
|
|
```
|
|
|
|
#### CR-regelafbrekingen gevonden [Windows]
|
|
|
|
Dit komt door de regelafbrekingstekens van Windows en de git-configuratie. Probeer het volgende:
|
|
|
|
```
|
|
git config --global core.autocrlf false
|
|
```
|
|
|
|
Verwijder dan de repository en kloon deze opnieuw.
|
|
|
|
#### Missing metadata schema
|
|
|
|
Tijdens de Twenty-installatie moet u uw Postgres-database voorzien van de juiste schema's, extensies en gebruikers.
|
|
Als het u lukt om deze provisioning uit te voeren, zou u `default` en `metadata` schema's in uw database moeten hebben.
|
|
Als dat niet het geval is, zorg ervoor dat u niet meer dan één Postgres-instantie op uw computer heeft draaien.
|
|
|
|
#### Kan module 'twenty-emails' of de bijbehorende typeverklaringen niet vinden.
|
|
|
|
U moet het pakket `twenty-emails` bouwen voordat u de database-initialisatie uitvoert met `npx nx run twenty-emails:build`
|
|
|
|
#### Missing twenty-x package
|
|
|
|
Zorg ervoor dat u in de hoofdmap `yarn` uitvoert en daarna `npx nx server:dev twenty-server`. Als het nog steeds niet werkt, probeer dan het ontbrekende pakket handmatig te bouwen.
|
|
|
|
#### Lint bij opslaan werkt niet
|
|
|
|
Dit zou zonder enige configuratie moeten werken met de geïnstalleerde eslint-extensie. Als dit niet werkt, probeer dan het volgende toe te voegen aan jouw vscode-instelling (op de ontwikkeling container scope):
|
|
|
|
```
|
|
"editor.codeActionsOnSave": {
|
|
|
|
"source.fixAll.eslint": "explicit"
|
|
|
|
}
|
|
```
|
|
|
|
#### Tijdens uitvoeren van `npx nx start` of `npx nx start twenty-front`, wordt er een geheugenfout gegenereerd
|
|
|
|
In `packages/twenty-front/.env` uncomment `VITE_DISABLE_TYPESCRIPT_CHECKER=true` en `VITE_DISABLE_ESLINT_CHECKER=true` om achtergrondcontroles te stoppen en zo het benodigde RAM-gebruik te verminderen.
|
|
|
|
**Als dit niet werkt:**
|
|
Voer alleen de services uit die u nodig heeft, in plaats van `npx nx start`. Bijvoorbeeld, als je aan de server werkt, voer alleen `npx nx worker twenty-server` uit.
|
|
|
|
**Als dit niet werkt:**
|
|
Als je geprobeerd hebt om alleen `npx nx run twenty-server:start` op WSL uit te voeren en het niet lukt met de hieronder beschreven geheugenfout:
|
|
|
|
`FATALE FOUT: Ineffectieve mark-compacts nabij heap-limiet Allocatie mislukt - JavaScript heap out of memory`
|
|
|
|
Een oplossing is om het onderstaande commando in de terminal uit te voeren of het toe te voegen aan het .bashrc-profiel om het automatisch in te stellen:
|
|
|
|
`export NODE_OPTIONS="--max-old-space-size=8192"`
|
|
|
|
De vlag --max-old-space-size=8192 stelt een bovengrens in van 8GB voor de Node.js-heap; gebruik schalen met de vraag van de applicatie.
|
|
Referentie: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048
|
|
|
|
**Als dit niet werkt:**
|
|
Onderzoek welke processen het meeste RAM van uw machine gebruiken. Bij Twenty merkten we dat sommige VScode-extensies veel RAM innamen, dus we schakelden ze tijdelijk uit.
|
|
|
|
**Als dit niet werkt:**
|
|
Het opnieuw opstarten van uw machine helpt om inactieve processen op te ruimen.
|
|
|
|
#### Tijdens uitvoeren van `npx nx start` verschijnen er vreemde [0] en [1] in logs
|
|
|
|
Dit wordt verwacht, aangezien het commando `npx nx start` meer commando's onder de motorkap uitvoert.
|
|
|
|
#### Er worden geen e-mails verzonden
|
|
|
|
Meestal komt dit omdat de `worker` niet op de achtergrond draait. Probeer het volgende
|
|
|
|
```
|
|
npx nx worker twenty-server
|
|
```
|
|
|
|
#### Kan geen verbinding maken met mijn Microsoft 365-account
|
|
|
|
Meestal is dit omdat uw beheerder de Microsoft 365 Licentie voor uw account niet heeft ingeschakeld. Bekijk [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).
|
|
|
|
Als je een foutcode `AADSTS50020` hebt, betekent dit waarschijnlijk dat je een persoonlijk Microsoft-account gebruikt. Dit wordt nog niet ondersteund. Meer info [hier](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist)
|
|
|
|
#### Tijdens gebruik van `yarn` verschijnen er waarschuwingen in de console
|
|
|
|
Waarschuwingen informeren over het binnenhalen van aanvullende afhankelijkheden die niet expliciet in `package.json` worden vermeld, dus zolang er geen kritieke fout optreedt, zou alles naar verwachting moeten werken.
|
|
|
|
#### Wanneer een gebruiker de inlogpagina opent, verschijnt er een foutmelding over een ongeautoriseerde gebruiker die probeert toegang te krijgen tot de werkruimte in logs
|
|
|
|
Dit wordt verwacht aangezien de gebruiker ongeautoriseerd is wanneer hij uitgelogd is, omdat zijn identiteit niet is geverifieerd.
|
|
|
|
#### Hoe te controleren of uw worker actief is?
|
|
|
|
- Ga naar [webhook-test.com](https://webhook-test.com/) en kopieer **Uw Unieke Webhook-URL**.
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Webhook test" />
|
|
</div>
|
|
- Open uw Twenty-app, ga naar `/settings` en schakel de **Geavanceerd** schakelaar in aan de onderkant links van het scherm.
|
|
- Maak een nieuwe webhook.
|
|
- Plak **Uw Unieke Webhook-URL** in het **Endpoint-URL** veld in Twenty. Stel de **Filters** in op `Bedrijven` en `Aangemaakt`.
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Webhook settings" />
|
|
</div>
|
|
- Ga naar `/objects/companies` en maak een nieuw bedrijfsrecord aan.
|
|
- Ga terug naar [webhook-test.com](https://webhook-test.com/) en controleer of er een nieuw **POST verzoek** is ontvangen.
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-test-result.jpg" alt="Webhook test result" />
|
|
</div>
|
|
- Als een **POST verzoek** wordt ontvangen, draait uw worker succesvol. Anders moet u uw workerproblemen oplossen.
|
|
|
|
#### Front-end start niet en retourneert fout TS5042: Optie 'project' kan niet worden gecombineerd met bronbestanden op een opdrachtregel
|
|
|
|
Comment out checker plugin in `packages/twenty-ui/vite-config.ts` like in example below
|
|
|
|
```
|
|
plugins: [
|
|
react({ jsxImportSource: '@emotion/react' }),
|
|
tsconfigPaths(),
|
|
svgr(),
|
|
dts(dtsConfig),
|
|
// checker(checkersConfig),
|
|
wyw({
|
|
include: [
|
|
'**/OverflowingTextWithTooltip.tsx',
|
|
'**/Chip.tsx',
|
|
'**/Tag.tsx',
|
|
'**/Avatar.tsx',
|
|
'**/AvatarChip.tsx',
|
|
],
|
|
babelOptions: {
|
|
presets: ['@babel/preset-typescript', '@babel/preset-react'],
|
|
},
|
|
}),
|
|
],
|
|
```
|
|
|
|
#### Beheerderspaneel niet toegankelijk
|
|
|
|
Voer `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'u@uwdomein.com';` in de databasecontainer uit om toegang te krijgen tot het beheerderspaneel.
|
|
|
|
### 1-klik Docker-compose
|
|
|
|
#### Kan niet inloggen
|
|
|
|
Als u niet kunt inloggen na de installatie:
|
|
|
|
1. Voer de volgende opdrachten uit:
|
|
```bash
|
|
docker exec -it twenty-server-1 yarn
|
|
docker exec -it twenty-server-1 npx nx database:reset --configuration=no-seed
|
|
```
|
|
2. Herstart de Docker-containers:
|
|
```bash
|
|
docker compose down
|
|
docker compose up -d
|
|
```
|
|
|
|
Let op: het database:reset-commando zal de database volledig wissen en opnieuw creëren.
|
|
|
|
#### Verbindingsproblemen achter een Reverse Proxy
|
|
|
|
Als u Twenty draait achter een reverse proxy en verbindingsproblemen ondervindt:
|
|
|
|
1. **Controleer SERVER_URL:**
|
|
|
|
Zorg ervoor dat `SERVER_URL` in uw `.env` bestand overeenkomt met uw externe toegang-URL, inclusief `https` als SSL is ingeschakeld.
|
|
|
|
2. **Controleer de instellingen van de reverse proxy:**
|
|
|
|
- Bevestig dat uw reverse proxy verzoeken correct doorstuurt naar de Twenty-server.
|
|
- Zorg ervoor dat headers zoals `X-Forwarded-For` en `X-Forwarded-Proto` correct zijn ingesteld.
|
|
|
|
3. **Herstart services:**
|
|
|
|
Na het aanbrengen van wijzigingen, start zowel de reverse proxy als de Twenty-containers opnieuw.
|
|
|
|
#### Fout bij het uploaden van een afbeelding - toestemming geweigerd
|
|
|
|
Het wijzigen van de eigendom van de gegevensmap op de host van root naar een andere gebruiker en groep lost dit probleem op.
|
|
|
|
## Hulp krijgen
|
|
|
|
Als u problemen tegenkomt die niet in deze handleiding zijn behandeld:
|
|
|
|
- Controleer logs:
|
|
|
|
Bekijk containerlogs voor foutmeldingen:
|
|
|
|
```bash
|
|
docker compose logs
|
|
```
|
|
|
|
- Ondersteuning vanuit de community:
|
|
|
|
Neem contact op met de [Twenty-gemeenschap](https://github.com/twentyhq/twenty/issues) of [ondersteuningskanalen](https://discord.gg/cx5n4Jzs57) voor hulp. |