documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Socket syntax unclear for dbhost variable

Open DataGhost opened this issue 10 months ago • 1 comments

Thanks for helping improve our documentation!

  • There is always room for improvement!
  • All contributions (changes and change ideas) - from the largest to the tiniest - help make Nextcloud better and easier to use!

The current documentation has a slight oversight when using unix sockets for the database connection https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#dbhost It looks like specifying 'dbhost' => '/path/to/socket' should be sufficient but that actually results in an internal server error with "Name or service not known" in the logs (or sometimes not, somehow). The correct syntax appears to be 'dbhost' => 'localhost:/path/to/socket' or even 'dbhost' => ':/path/to/socket' though I am not sure the latter syntax is portable across all databases.


Notes

  • Please be patient: this is a large open source project that is overseen by a mixture of volunteers and non-volunteers which are all ultimately busy.
  • If your suggestion is a troubleshooting scenario or one you're not 100% certain about, please post for feedback on the Nextcloud Help Forum first.
    • Then return here to bring back your experience to help improve the documentation for clarity, etc. (and link back to the forum discussion in your report!)

Protip: If you want to help move things along (or just help out in other ways too) here are some suggestions:

  • Look for areas where you can assist - even seemingly unrelated areas - because doing so frees up resources for your favorite topics and ideas.
  • Submit a proposed change - that attempts to addresses your issue - as a pull request.
  • Participate in a discussion on some other unresolved submitted idea ("issues") to help move it along.
  • Post a comment or review on someone else's proposed change ("pull request") to help move it along.

DataGhost avatar Apr 15 '24 12:04 DataGhost