Skip to main content

๐Ÿ› ๏ธ Troubleshooting

Sponsored by Open WebUI Inc.
Open WebUI Inc.

We are hiring! Shape the way humanity engages with intelligence.

๐ŸŒŸ General Troubleshooting Tipsโ€‹

Encountering issues? Don't worry, we're here to help! ๐Ÿ˜Š Start with this important step:

  • ๐Ÿ”„ Make sure you're using the latest version of the software.
  • ๐Ÿ’พ Check for Configuration Persistence: Open WebUI prioritizes settings stored in its internal database over environment variables for certain settings (marked as PersistentConfig). If your environment changes (like ENABLE_SIGNUP=True) seem to be ignored, see the Environment Variable Configuration page for how to force updates or manually edit the database.

With this project constantly evolving, updates and fixes are regularly added. Keeping your software up-to-date is crucial to take advantage of all the enhancements and fixes, ensuring the best possible experience. ๐Ÿš€

๐Ÿค Community Supportโ€‹

This project thrives on community spirit and passion. If you still face problems after updating, we warmly invite you to join our vibrant community on Discord. There, you can share your experiences, find solutions, and connect with fellow enthusiasts who might be navigating similar challenges. Engaging with our community doesn't just help solve your problems; it strengthens the entire network of support, so we all grow together. ๐ŸŒฑ

๐ŸŒŸ If your issues are pressing and you need a quicker resolution, consider supporting our project. Your sponsorship not only fast-tracks your queries in a dedicated sponsor-only channel, but also directly supports the dedicated maintainer who is passionately committed to refining and enhancing this tool for everyone.

๐Ÿงช Help Prevent Future Issuesโ€‹

Want to help prevent issues like this from reaching stable releases? Consider running the development branch! Testing dev builds is one of the most valuable contributions you can makeโ€”no code required. Just use it and report any issues you find.

Together, let's harness these opportunities to create the best environment and keep pushing the boundaries of what we can achieve with our project. Thank you from the bottom of our hearts for your understanding, cooperation, and belief in our mission! ๐Ÿ™