Files
twenty/packages/twenty-docs/l/nl/developers/self-hosting/troubleshooting.mdx
T
8cadd00d34 i18n - translations (#15799)
Created by Github action

---------

Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
Co-authored-by: github-actions <github-actions@twenty.com>
2025-11-13 16:34:00 +01:00

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.