Skip to main content

Common Issues

This section addresses some of the most common issues users may encounter while using the Owlistic, along with their solutions.

Issue 1: Application Won't Start​

Symptoms: The application fails to launch, and no error messages are displayed.

Solution:

  • Ensure that all system requirements are met.
  • Check if the necessary dependencies are installed. Run the installation command again to ensure all packages are correctly set up.

Issue 2: Unable to Save Notes​

Symptoms: Changes made to notes are not being saved.

Solution:

  • Verify that you have write permissions for the directory where the notes are stored.
  • Check if the application has sufficient storage space available.

Issue 3: Database Connection Errors​

Symptoms: The application displays errors related to database connectivity.

Solution:

  • Ensure that the database server is running.
  • Check the database configuration settings in the configuration/database-setup.md file to ensure they are correct.

Issue 4: Sync Issues Across Devices​

Symptoms: Notes are not syncing properly between devices.

Solution:

  • Ensure that you are logged into the same account on all devices.
  • Check your internet connection and try refreshing the app.

Issue 5: Performance Issues​

Symptoms: The application is running slowly or freezing.

Solution:

  • Try closing other applications to free up system resources.
  • Refer to the troubleshooting/performance.md file for additional tips on improving performance.

Additional Help​

If you continue to experience issues try the following:

  1. Check the FAQs.
  2. Read through the Release Notes.
  3. Search through existing GitHub Issues.