docs/pages/self-hosting/troubleshooting.mdx

46 lines
2.6 KiB
Plaintext
Raw Normal View History

2023-12-12 18:36:07 +00:00
---
title: 'Troubleshooting'
---
2023-12-12 18:28:16 +00:00
2023-12-31 14:39:55 +00:00
# Troubleshooting
2023-12-12 18:28:16 +00:00
There is always a possibility for something to go wrong while trying to deploy your own instance of movie-web. This page will contain common issues people have come across while self-hosting and their solutions.
2023-12-12 23:08:31 +00:00
## "Failed to find media, try again!" while searching
**This is likely a misconfigured TMDB API key.** To verify that TMDB is the issue, visit `/admin` or `/#/admin` and click on the `Test TMDB` button.
2023-12-12 23:08:31 +00:00
If the test succeeds, then your TMDB configuration is correct and the issue is with something else.
2023-12-12 23:08:31 +00:00
If the test fails, then you should recheck your credentials. [**Make sure you're using the Read Access Token, not the normal API Key.**](https://www.themoviedb.org/settings/api#v4_auth_key)
2023-12-12 23:08:31 +00:00
## Everything I try to watch fails
**This is likely a misconfigured Worker.** To make sure that the Workers are the issue, visit `/admin` or `/#/admin`, then click on the `Test workers` button.
2023-12-12 23:08:31 +00:00
2024-03-31 01:02:57 +00:00
You should have at least 1 Worker registered, if you don't, you should [deploy a worker](../proxy/deploy.mdx) and [set it up in the client](../client/configuration.mdx#vite-cors-proxy-url).
2023-12-12 23:08:31 +00:00
If any Worker fails the test, you should double check its URL and see if its up to date with the latest updates.
2023-12-12 23:08:31 +00:00
## I can't make an account or login
**This is likely misconfigured or broken backend.** To verify that the backend is the issue, visit `/admin` or `/#/admin`, then click on the `Test backend` button.
2023-12-12 23:08:31 +00:00
2024-03-31 01:02:57 +00:00
If the backend is online and properly configured it should display the name and version of the backend. If the name and description of the test don't match your own instance, [make sure you have your backend URL set correctly.](../client/configuration.mdx#vite-backend-url)
2023-12-12 23:08:31 +00:00
2024-03-31 01:02:57 +00:00
If the test gives you an error, your [backend URL configuration option](../client/configuration.mdx#vite-backend-url) likely has a typo.
2023-12-12 23:08:31 +00:00
If the version that shows up on your backend is not the latest version, you should update your backend to keep up with the latest changes.
2023-12-12 23:08:31 +00:00
## I updated from version 3 to version 4 but I still see the old version
2023-12-12 23:08:31 +00:00
It is likely that you haven't installed the PWA version of movie-web. Please read the [upgrade guide](../client/upgrade.mdx) for more details on the matter.
2023-12-31 14:39:55 +00:00
## I'm getting SSL issues when using a hosted postgres database
2024-03-31 01:02:57 +00:00
You are most likely missing the [`postgres.ssl`](../backend/configuration.mdx#postgres-ssl) variable on your backend, enable it and the connection should work.
2023-12-31 14:39:55 +00:00
## Permission denied to set parameter "session_replication_role"
Set the `MIKRO_ORM_MIGRATIONS_DISABLE_FOREIGN_KEYS` option to `false` in either your `.env` or your Docker command.