Bug 28151 - Missing documentation on variable "access_dir"
Summary: Missing documentation on variable "access_dir"
Status: Needs documenting
Alias: None
Product: Koha
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Main
Hardware: All All
: P5 - low normal (vote)
Assignee: Bugs List
QA Contact: Testopia
Keywords: Manual
Depends on: 11317
  Show dependency treegraph
Reported: 2021-04-15 09:02 UTC by Michael Kuhn
Modified: 2024-02-07 20:36 UTC (History)
6 users (show)

See Also:
Change sponsored?: ---
Patch complexity: ---
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:


Note You need to log in before you can comment on or make changes to this bug.
Description Michael Kuhn 2021-04-15 09:02:33 UTC
Bug 11317 introduced in Koha 18.05 a new variable "access_dir" which is nowhere documented in the Koha manual, as far as I could see. In new Koha installations  the following can be found in "koha-conf.xml"


but it is nowhere explained how to set or how to use these veriables.

In older versions of Koha that are updated these variables are missing and as far as I can remember there is no notice that they should/could be added.

However, if you click Koha menu "Tools > Access files" you will get the message:

Error: Files could not be found because the "access_dir" option was not set in "koha-conf.xml". Contact your system administrator to add this option.

There is section https://koha-community.org/manual/20.11/en/html/tools.html#access-files in the manual but it just says "The directories where the files are stored need to be defined in the koha-conf.xml file." without further explanation.
Comment 1 Katrin Fischer 2022-07-04 12:45:01 UTC
The access_dir is used as the path or paths for the "Access file" tool, there is no other use I am aware of.
Comment 2 Magnus Enger 2024-02-07 13:24:00 UTC
Would it make sense to hide "Tools > Access files" from the Tools main page, if the config is not activated? As it stands now, it looks like something was supposed to be shown there, but it is not shown because someone forgot to configure something.
Comment 3 Katrin Fischer 2024-02-07 20:36:51 UTC
I think it shows a hint on the missing configuration now on the page. I believe if you want to hide it, you could also not give the permission to users.