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: Feilsøking
|
|
image: /images/user-guide/what-is-twenty/20.png
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Feilsøking
|
|
|
|
Hvis du møter problemer under oppsett av miljø for utvikling, oppgradering av instans eller selv-hosting,
|
|
her er noen løsninger for vanlige problemer.
|
|
|
|
### Egen hosting
|
|
|
|
#### Første installasjon resulterer i `passordautentisering feilet for bruker "postgres"`
|
|
|
|
🚨 **VIKTIG: Denne løsningen er KUN for ferske installasjoner** 🚨
|
|
Hvis du har en eksisterende Twenty-instans med produksjonsdata, **IKKE** følg disse trinnene da de vil slette databasen din permanent!
|
|
|
|
Når du installerer Twenty for første gang, vil du kanskje endre det forhåndsinnstilte databasepassordet.
|
|
Passordet du setter under den første installasjonen blir permanent lagret i databasevolumet. Hvis du senere prøver å endre dette passordet i konfigurasjonen uten å fjerne det gamle volumet, vil du få autentiseringsfeil fordi databasen fortsatt bruker det opprinnelige passordet.
|
|
|
|
⚠️ ADVARSEL: Følgende trinn vil SLETTE all databasedata PERMANENT! ⚠️
|
|
Fortsett kun hvis dette er en fersk installasjon uten viktig data.
|
|
|
|
For å oppdatere `PG_DATABASE_PASSWORD` må du:
|
|
|
|
```sh
|
|
# Update the PG_DATABASE_PASSWORD in .env
|
|
docker compose down --volumes
|
|
docker compose up -d
|
|
```
|
|
|
|
#### CR-linjeskift funnet [Windows]
|
|
|
|
Dette skyldes linjeskift-tegnene i Windows og git-konfigurasjonen. Prøv å kjøre:
|
|
|
|
```
|
|
git config --global core.autocrlf false
|
|
```
|
|
|
|
Deretter slett depotet og klon det igjen.
|
|
|
|
#### Manglende metadataschema
|
|
|
|
Under Twenty-installasjonen må du forsyne postgres-databasen din med de riktige schemaene, utvidelsene og brukerne.
|
|
Hvis du lykkes med å kjøre denne forsyningen, bør du ha `default` og `metadata` schemaer i databasen din.
|
|
Hvis du ikke gjør det, sørg for at du ikke har mer enn én postgres-instans kjørende på datamaskinen din.
|
|
|
|
#### Kan ikke finne modul 'twenty-emails' eller de tilsvarende typedeklarasjonene.
|
|
|
|
Du må bygge pakken `twenty-emails` før du kjører initialiseringen av databasen med `npx nx run twenty-emails:build`
|
|
|
|
#### Manglende twenty-x-pakke
|
|
|
|
Forsikre deg om at du kjører yarn i rotkatalogen, og deretter `npx nx server:dev twenty-server`. Hvis dette fortsatt ikke fungerer, prøv å bygge den manglende pakken manuelt.
|
|
|
|
#### Lint-on-Save fungerer ikke
|
|
|
|
Dette bør fungere automatisk med eslint-utvidelsen installert. Hvis dette ikke fungerer, prøv å legge til dette i din vscode-innstilling (under utviklingscontainer-omfang):
|
|
|
|
```
|
|
"editor.codeActionsOnSave": {
|
|
|
|
"source.fixAll.eslint": "explicit"
|
|
|
|
}
|
|
```
|
|
|
|
#### Mens du kjører `npx nx start` eller `npx nx start twenty-front`, kan det oppstå en minnefeil
|
|
|
|
I `packages/twenty-front/.env` fjern kommentar fra `VITE_DISABLE_TYPESCRIPT_CHECKER=true` og `VITE_DISABLE_ESLINT_CHECKER=true` for å deaktivere bakgrunnssjekker og dermed redusere RAM-behovet.
|
|
|
|
**Hvis det ikke fungerer:**
|
|
Kun kjør tjenestene du trenger, i stedet for `npx nx start`. For eksempel, hvis du jobber på serveren, kjør bare `npx nx worker twenty-server`
|
|
|
|
**Hvis det ikke fungerer:**
|
|
Hvis du prøvde å kjøre bare `npx nx run twenty-server:start` på WSL og det feiler med feilmeldingen nedenfor om minne:
|
|
|
|
\`FATAL ERROR: Ineffektive mark-kompakter nær heapgrensen. Allokering feilet - JavaScript-heapen er tom for minne
|
|
|
|
Løsning er å kjøre kommandoen nedenfor i terminalen eller legge den til i .bashrc-profilen for å få oppsettet automatisk:
|
|
|
|
`export NODE_OPTIONS="--max-old-space-size=8192"`
|
|
|
|
Flagget --max-old-space-size=8192 setter en øvre grense på 8GB for Node.js-heapen; bruken skalerer med applikasjonsbehovet.
|
|
Referanse: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048
|
|
|
|
**Hvis det ikke fungerer:**
|
|
Undersøk hvilke prosesser som bruker det meste av din maskins RAM. Hos Twenty merket vi at noen VScode-utvidelser brukte mye RAM, så vi deaktiverte dem midlertidig.
|
|
|
|
**Hvis det ikke fungerer:**
|
|
Å starte maskinen på nytt bidrar til å rydde opp i spøkelsesprosesser.
|
|
|
|
#### Når du kjører `npx nx start` er det merkelige [0] og [1] i loggene
|
|
|
|
Dette er forventet, siden kommandoen `npx nx start` kjører flere kommandoer i bakgrunnen
|
|
|
|
#### Ingen e-poster sendes
|
|
|
|
Som oftest er det fordi `worker` ikke kjører i bakgrunnen. Prøv å kjøre
|
|
|
|
```
|
|
npx nx worker twenty-server
|
|
```
|
|
|
|
#### Kan ikke koble min Microsoft 365-konto
|
|
|
|
Som oftest er dette fordi din administrator ikke har aktivert Microsoft 365-lisensen for kontoen din. Sjekk [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).
|
|
|
|
Hvis du har feilkoden `AADSTS50020`, betyr det sannsynligvis at du bruker en personlig Microsoft-konto. Dette støttes ikke ennå. Mer 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 kjører `yarn` vises advarsler i konsollen
|
|
|
|
Advarslene informerer om innhenting av tilleggsavhengigheter som ikke er eksplisitt oppgitt i `package.json`, så lenge det ikke oppstår noen alvorlige feil, bør alt fungere som forventet.
|
|
|
|
#### Når en bruker får tilgang til innloggingssiden, oppstår det en feil om uautorisert bruker som prøver å få tilgang til arbeidsområdet i loggene
|
|
|
|
Dette er forventet, siden brukeren er uautorisert når de er utlogget fordi identiteten ikke er bekreftet.
|
|
|
|
#### Hvordan sjekke om din worker kjører?
|
|
|
|
- Gå til [webhook-test.com](https://webhook-test.com/) og kopier **Din unike Webhook-URL**.
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Webhook test" />
|
|
</div>
|
|
- Åpne din Twenty-app, naviger til `/settings`, og aktiver **Avansert** bryteren nederst til venstre på skjermen.
|
|
- Opprett en ny webhook.
|
|
- Lim inn **Din unike Webhook-URL** i **Endpoint Url**-feltet i Twenty. Sett **Filtre** til `Selskaper` og `Opprettet`.
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Webhook settings" />
|
|
</div>
|
|
- Gå til `/objects/companies` og opprett en ny selskapsoppføring.
|
|
- Return to [webhook-test.com](https://webhook-test.com/) and check if a new **POST request** has been received.
|
|
<div style={{textAlign: 'center'}}>
|
|
<img src="/images/docs/developers/self-hosting/webhook-test-result.jpg" alt="Webhook test result" />
|
|
</div>
|
|
- Hvis en **POST-forespørsel** blir mottatt, kjører din worker suksessfullt. Hvis ikke, må du feilsøke din worker.
|
|
|
|
#### Frontend feiler ved oppstart og returnerer feil TS5042: Alternativet 'prosjekt' kan ikke blandes med kildefiler på en kommandolinje
|
|
|
|
Kommenter ut checker plugin i `packages/twenty-ui/vite-config.ts` som i eksempelet nedenfor
|
|
|
|
```
|
|
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'],
|
|
},
|
|
}),
|
|
],
|
|
```
|
|
|
|
#### Administrasjonspanel ikke tilgjengelig
|
|
|
|
Run `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` in database container to get access to admin panel.
|
|
|
|
### 1-click Docker compose
|
|
|
|
#### Kan ikke logge inn
|
|
|
|
If you can't log in after setup:
|
|
|
|
1. Kjør de følgende kommandoene:
|
|
```bash
|
|
docker exec -it twenty-server-1 yarn
|
|
docker exec -it twenty-server-1 npx nx database:reset --configuration=no-seed
|
|
```
|
|
2. Start Docker-konteinerne på nytt:
|
|
```bash
|
|
docker compose down
|
|
docker compose up -d
|
|
```
|
|
|
|
Merk at kommandoen database:reset vil fullstendig slette databasen din og gjenopprette den fra bunnen av.
|
|
|
|
#### Tilkoblingsproblemer bak en omvendt proxy
|
|
|
|
Hvis du kjører Twenty bak en omvendt proxy og opplever tilkoblingsproblemer:
|
|
|
|
1. **Verifiser SERVER_URL:**
|
|
|
|
Sikre at `SERVER_URL` i din `.env`-fil samsvarer med din eksterne tilgangs-URL, inkludert `https` hvis SSL er aktivert.
|
|
|
|
2. **Sjekk innstillinger for omvendt proxy:**
|
|
|
|
- Kontroller at din omvendte proxy sender forespørslene riktig til Twenty-serveren.
|
|
- Sørg for at headere som `X-Forwarded-For` og `X-Forwarded-Proto` er riktig satt.
|
|
|
|
3. **Start tjenester på nytt:**
|
|
|
|
Etter å ha gjort endringer, start både den omvendte proxyen og Twenty-konteinerne på nytt.
|
|
|
|
#### Feil ved opplasting av et bilde - tillatelse nektes
|
|
|
|
Å endre datafoldereierskap på verten fra root til en annen bruker og gruppe løser dette problemet.
|
|
|
|
## Få hjelp
|
|
|
|
Hvis du opplever problemer som ikke er dekket i denne veiledningen:
|
|
|
|
- Sjekk logger:
|
|
|
|
Se containerlogger for feilmeldinger:
|
|
|
|
```bash
|
|
docker compose logs
|
|
```
|
|
|
|
- Fellesskapsstøtte:
|
|
|
|
Ta kontakt med [Twenty-fellesskapet](https://github.com/twentyhq/twenty/issues) eller [støttekanaler](https://discord.gg/cx5n4Jzs57) for hjelp. |