Created by Github action --------- Co-authored-by: Crowdin Bot <support+bot@crowdin.com> Co-authored-by: github-actions <github-actions@twenty.com>
227 lines
8.9 KiB
Plaintext
227 lines
8.9 KiB
Plaintext
---
|
|
title: Fejlfinding
|
|
image: /images/user-guide/what-is-twenty/20.png
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Fejlfinding
|
|
|
|
If you encounter any problem while setting up environment for development, upgrading your instance or self-hosting,
|
|
here are some solutions for common problems.
|
|
|
|
### Selv-hosting
|
|
|
|
#### Første installation resulterer i `password authentication failed for user "postgres"`
|
|
|
|
🚨 **VIGTIGT: Denne løsning er KUN for nye installationer** 🚨
|
|
Hvis du har en eksisterende Twenty-instans med produktionsdata, **FØLG IKKE** disse trin, da de permanent vil slette din database!
|
|
|
|
Mens du installerer Twenty for første gang, kan du skifte standarddatabaseadgangskoden.
|
|
Adgangskoden, du sætter under den første installation, bliver permanent gemt i databasevolumen. Hvis du senere prøver at ændre denne adgangskode i din konfiguration uden at fjerne det gamle volumen, vil du få godkendelsesfejl, fordi databasen stadig bruger den oprindelige adgangskode.
|
|
|
|
⚠️ ADVARSEL: Følgende trin vil PERMANENT slette alle databasedata! ⚠️
|
|
Fortsæt kun, hvis dette er en ny installation uden vigtige data.
|
|
|
|
For at opdatere `PG_DATABASE_PASSWORD` skal du:
|
|
|
|
```sh
|
|
# Update the PG_DATABASE_PASSWORD in .env
|
|
docker compose down --volumes
|
|
docker compose up -d
|
|
```
|
|
|
|
#### CR-linjeskift fundet [Windows]
|
|
|
|
Dette skyldes linje-skifttegnene for Windows og git-konfigurationen. Prøv at køre:
|
|
|
|
```
|
|
git config --global core.autocrlf false
|
|
```
|
|
|
|
Slet derefter repositariet og klon det igen.
|
|
|
|
#### Manglende metadata-schema
|
|
|
|
Under Twenty-installationen skal du forsyne din postgres-database med de korrekte skemaer, udvidelser og brugere.
|
|
Hvis du lykkes med at køre denne provisioning, skal du have `default` og `metadata` skemaer i din database.
|
|
Hvis du ikke har det, skal du sørge for, at du ikke har mere end en postgres-instans, der kører på din computer.
|
|
|
|
#### Kan ikke finde modul 'twenty-emails' eller dets tilsvarende typedeklarationer.
|
|
|
|
Du skal bygge pakken `twenty-emails` før du kører initialiseringen af databasen med `npx nx run twenty-emails:build`
|
|
|
|
#### Mangler twenty-x pakke
|
|
|
|
Sørg for at køre yarn i rodmappen og derefter køre `npx nx server:dev twenty-server`. Hvis dette stadig ikke virker, prøv at bygge den manglende pakke manuelt.
|
|
|
|
#### Lint ved gem ikke virker
|
|
|
|
Dette skulle virke automatisk med den installerede eslint-udvidelse. Hvis dette ikke virker, prøv at tilføje dette til dine vscode-indstillinger (på dev-kontainerscopen):
|
|
|
|
```
|
|
"editor.codeActionsOnSave": {
|
|
|
|
"source.fixAll.eslint": "explicit"
|
|
|
|
}
|
|
```
|
|
|
|
#### Mens du kører `npx nx start` eller `npx nx start twenty-front`, kastes der en 'Out of memory' fejl
|
|
|
|
I `packages/twenty-front/.env` fjern kommenteringen af `VITE_DISABLE_TYPESCRIPT_CHECKER=true` og `VITE_DISABLE_ESLINT_CHECKER=true` for at deaktivere baggrundskontroller, hvilket reducerer behovet for RAM.
|
|
|
|
**Hvis det ikke virker:**
|
|
Kør kun de tjenester, du har brug for, i stedet for `npx nx start`. For eksempel, hvis du arbejder på serveren, kør bare `npx nx worker twenty-server`
|
|
|
|
**Hvis det ikke virker:**
|
|
Hvis du forsøgte at køre kun `npx nx run twenty-server:start` på WSL, og det fejler med nedenstående hukommelsesfejl:
|
|
|
|
`FATAL ERROR: Ineffektive mark-kompaktier nær heap-grænse Tildeling mislykkedes - JavaScript heap ude af hukommelse`
|
|
|
|
En midlertidig løsning er at udføre nedenstående kommando i terminalen eller tilføje den i .bashrc-profilen for at få opsætningen automatisk:
|
|
|
|
`export NODE_OPTIONS="--max-old-space-size=8192"`
|
|
|
|
Flaget --max-old-space-size=8192 sætter en øvre grænse på 8GB for Node.js heap; brugen stiger med applikationsbehov.
|
|
Referencer: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048
|
|
|
|
**Hvis det ikke virker:**
|
|
Undersøg hvilke processer, der tager mest af din maskins RAM. Hos Twenty bemærkede vi, at nogle VScode-udvidelser tog meget RAM, så vi deaktiverede dem midlertidigt.
|
|
|
|
**Hvis det ikke virker:**
|
|
Genstart af din maskine hjælper med at rydde spøgelsesprocesser.
|
|
|
|
#### Mens du kører `npx nx start`, er der underlige [0] og [1] i loggene
|
|
|
|
Det er forventet, da kommandoen `npx nx start` kører flere kommandoer i baggrunden.
|
|
|
|
#### Ingen e-mails bliver sendt
|
|
|
|
Det skyldes oftest, at `worker` ikke kører i baggrunden. Prøv at køre
|
|
|
|
```
|
|
npx nx worker twenty-server
|
|
```
|
|
|
|
#### Kan ikke tilslutte min Microsoft 365-konto
|
|
|
|
Det skyldes oftest, at din administrator ikke har aktiveret Microsoft 365-licensen for din konto. Tjek [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).
|
|
|
|
Hvis du har en fejlmeddelelse `AADSTS50020`, betyder det sandsynligvis, at du bruger en personlig Microsoft-konto. Det er ikke understøttet endnu. Mere info [her](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist)
|
|
|
|
#### Mens du kører `yarn`, dukker der advarsler op i konsollen
|
|
|
|
Advarsler informerer om tilføjelse af ekstra afhængigheder, der ikke er eksplicit angivet i `package.json`, så længe der ikke vises nogen gennemgående fejl, skulle alt fungere som forventet.
|
|
|
|
#### Når brugeren får adgang til login-siden, vises en fejl om uautoriseret bruger, der forsøger at få adgang til arbejdsområde i loggene
|
|
|
|
Det er forventet, da brugeren er uautoriseret, når den er logget ud, da dens identitet ikke er verificeret.
|
|
|
|
#### Hvordan tjekker du, om din worker kører?
|
|
|
|
- Gå til [webhook-test.com](https://webhook-test.com/) og kopier **Din Unikke Webhook-URL**.
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Webhook test" />
|
|
</div>
|
|
- Åbn din Twenty-app, naviger til `/settings`, og aktiver **Avanceret** skiftet nederst til venstre på skærmen.
|
|
- Opret en ny webhook.
|
|
- Indsæt **Din Unikke Webhook-URL** i **Endpoint Url**-feltet i Twenty. Sæt **Filtre** til `Companies` og `Created`.
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Webhook settings" />
|
|
</div>
|
|
- Gå til `/objects/companies` og opret en ny virksomhedsoptegnelse.
|
|
- Vend tilbage til [webhook-test.com](https://webhook-test.com/) og kontroller, om en ny **POST-anmodning** er modtaget.
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-test-result.jpg" alt="Webhook test result" />
|
|
</div>
|
|
- Hvis der modtages en **POST-anmodning**, kører din worker korrekt. Ellers skal du fejlsøge din worker.
|
|
|
|
#### Front-end kan ikke starte og returnerer fejlen TS5042: Option 'project' kan ikke blandes med kildefiler på kommandolinjen
|
|
|
|
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'],
|
|
},
|
|
}),
|
|
],
|
|
```
|
|
|
|
#### Admin panel ikke tilgængeligt
|
|
|
|
Kør `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` i database containeren for at få adgang til admin-panelet.
|
|
|
|
### 1-klik Docker compose
|
|
|
|
#### Kan ikke logge ind
|
|
|
|
Hvis du ikke kan logge ind efter opsætning:
|
|
|
|
1. Kør følgende kommandoer:
|
|
```bash
|
|
docker exec -it twenty-server-1 yarn
|
|
docker exec -it twenty-server-1 npx nx database:reset --configuration=no-seed
|
|
```
|
|
2. Restart the Docker containers:
|
|
```bash
|
|
docker compose down
|
|
docker compose up -d
|
|
```
|
|
|
|
Bemærk, at kommandoen database:reset vil fuldstændigt slette din database og oprette den fra bunden.
|
|
|
|
#### Forbindelsesproblemer bag en reverse proxy
|
|
|
|
Hvis du kører Twenty bag en reverse proxy og oplever forbindelsesproblemer:
|
|
|
|
1. **Verificer SERVER_URL:**
|
|
|
|
Sørg for, at `SERVER_URL` i din `.env` fil matcher din eksterne adgangs-URL, inklusive `https` hvis SSL er aktiveret.
|
|
|
|
2. **Tjek indstillinger for reverse proxy:**
|
|
|
|
- Bekræft, at din reverse proxy korrekt videresender forespørgsler til Twenty-serveren.
|
|
- Sørg for at overskrifter som `X-Forwarded-For` og `X-Forwarded-Proto` er korrekt indstillet.
|
|
|
|
3. **Genstart tjenester:**
|
|
|
|
Efter at have foretaget ændringer skal du genstarte både reverse proxy og Twenty containere.
|
|
|
|
#### Fejl ved upload af et billede - tilladelse nægtet
|
|
|
|
Ændring af ejerskab af datamappen på værten fra root til en anden bruger og gruppe løser dette problem.
|
|
|
|
## At få hjælp
|
|
|
|
Hvis du støder på problemer, der ikke er dækket i denne vejledning:
|
|
|
|
- Tjek Logfiler:
|
|
|
|
Se containerlogfiler for fejlmeddelelser:
|
|
|
|
```bash
|
|
docker compose logs
|
|
```
|
|
|
|
- Fællesskabsstøtte:
|
|
|
|
Kontakt [Twenty-fællesskabet](https://github.com/twentyhq/twenty/issues) eller [supportkanaler](https://discord.gg/cx5n4Jzs57) for hjælp. |