github/directus
1
1
Fork 0
mirror of https://github.com/directus/directus.git synced 2026-04-25 03:00:53 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add Troubleshooting

Browse Source
This commit is contained in:
Ben Haynes
2021-05-17 17:24:33 -04:00
committed by GitHub
parent f06ac03755
commit 749ca7effb
1 changed files with 19 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/getting-started/support.md
View File

@@ -3,6 +3,25 @@
> Directus is offered completely free and open-source for anyone wishing to self-host the platform. If you have
> questions along the way, there are many resources, both free and paid, to help you get up-and-running smoothly.
## Troubleshooting Steps
If you're experiencing issues or think you have found a problem in Directus, be sure to follow these steps before [Reporting a Bug](/contributing/introduction/#bug-reporting):
1. Ensure your server/database meet the [minimum requirements](/guides/installation/cli/#_1-confirm-minimum-requirements)
2. Ensure you’re on the [latest version of Directus](https://github.com/directus/directus/releases/latest)
3. Stop (`CTRL+C`) and restart the server (`npx directus start`)
5. Run the database migration script: `directus database migrate:latest` (backup your database first)
6. Disable any data-caching within your project
7. Test any App issues with browser extensions and cache disabled (eg: Incognito Mode)
8. Confirm the issue is not related to your own custom code
9. Check for [existing Issues](https://github.com/directus/directus/issues?q=is%3Aissue) (and [Discussions](https://github.com/directus/directus/discussions)) that match your problem
::: tip Source Contributors
Those who have installed from source should also remove all dependencies (`npx lerna clean -y`) and then reinstall them (`npm install`).
:::
If you're still experiencing a problem after completing the above steps, you can chat through things on our [community support](#community-support) or [report a bug](/contributing/introduction/#bug-reporting).
## Community Support
[Github Discussions](https://github.com/directus/directus/discussions) is great first place to reach out for help. Our