[ Kavita ] Self-hosted digital book library

Discussion on apps, protocols, APIs, specifications, and more. You are welcome to join us as a TOS app developer!
User avatar
outkastm
Gold Member
Posts: 1486
Joined: 29 Dec 2020, 23:52

Re: [ Kavita ] Self-hosted digital book library

Post by outkastm »

As the user home directory is not a shared folder, you need to assign read permission for KavitaOkm to this folder, to allow traverse to the media folders inside.
In addition to the media folder (or the folders with the books) that exist under /Volume1/homes/user, assign these permissions to /Volume1/homes/user
Image

Then in Kavita library select /Volume1/homes/user/media.
User avatar
Metaladict
Posts: 5
Joined: 24 Jul 2026, 04:01
Peru

Re: [ Kavita ] Self-hosted digital book library

Post by Metaladict »

outkastm wrote: ↑Yesterday, 08:19 As the user home directory is not a shared folder, you need to assign read permission for KavitaOkm to this folder, to allow traverse to the media folders inside.
In addition to the media folder (or the folders with the books) that exist under /Volume1/homes/user, assign these permissions to /Volume1/homes/user
Image

Then in Kavita library select /Volume1/homes/user/media.
Yes, the user KavitaOkm has full access. I had the same problem with PLEX and fixed it this way, but KAVITA doesn't have access, as you can see in the image.


Image
User avatar
outkastm
Gold Member
Posts: 1486
Joined: 29 Dec 2020, 23:52

Re: [ Kavita ] Self-hosted digital book library

Post by outkastm »

From your screenshot, i think you are already in the user folder. You need to assign these permission while on the homes folder.
Image

You can double check using terminal and also provide the access via terminal.
Login on TOS using your admin user and open Terminal.
We'll give access to KavitaOkm application user to folder Books folder in the home folder of user test:

Code: Select all

##KavitaOkm need access to "Books" folder inside the user "test" home folder: /Volume1/homes/test/Books
#test KavitaOkm read access to /Volume1/homes. Access OK
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes"
total 48
drwxr-xr-x+  6 nas   nas   4096 Nov 21 14:03 .
drwxr-xr-x  34 www-data www-data 4096 Nov 20 23:44 ..
drwxrwxrwx+  5 nas   nas   4096 Nov 21 10:08 user2
drwxr-xr-x+ 11 nas   nas   4096 Nov 20 22:54 nas
drwxrwxrwx+  3 nas   nas   4096 Apr 17  2026 super
drwxrwxrwx+  3 nas   nas   4096 Nov 21 14:03 test

#test KavitaOkm access to /Volume1/homes/test. Permission denied
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test"
ls: cannot open directory '/Volume1/homes/test': Permission denied

#Grant read access for KavitaOkm to /Volume1/homes/test.
nas@F2-221:/# tmacltool modify /Volume1/homes/test user:KavitaOkm:allow:r-x---a-R-c--:----

#test KavitaOkm access to /Volume1/homes/test. Access OK
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test"
total 32
drwxrwxrwx+ 2 nas nas 4096 Nov 21 14:03 '#recycle'
drwxrwxrwx+ 4 nas nas 4096 Nov 21 14:04  .
drwxr-xr-x+ 6 nas nas 4096 Nov 21 14:03  ..
drwxrwxrwx+ 2 nas nas 4096 Nov 21 14:04  Books

#test KavitaOkm access to /Volume1/homes/test/Books. Permission denied
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test/Books"
ls: cannot open directory '/Volume1/homes/test/Books': Permission denied

#Grant read/write and inherited access for KavitaOkm to /Volume1/homes/test/Books.
nas@F2-221:/# tmacltool add /Volume1/homes/test/Books user:KavitaOkm:allow:rwxpdDaARWc--:fd--

#test KavitaOkm access to /Volume1/homes/test/Books. Access OK
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test/Books"
total 24
drwxrwxrwx+ 3 nas nas 4096 Nov 21 14:09  .
drwxrwxrwx+ 4 nas nas 4096 Nov 21 14:04  ..
drwxrwxrwx+ 2 nas nas 4096 Nov 21 14:10 'After 20 years'
Add /Volume1/homes/test/Books to library
Image

Image
User avatar
Metaladict
Posts: 5
Joined: 24 Jul 2026, 04:01
Peru

Re: [ Kavita ] Self-hosted digital book library

Post by Metaladict »

outkastm wrote: ↑Yesterday, 21:35 From your screenshot, i think you are already in the user folder. You need to assign these permission while on the homes folder.
Image

You can double check using terminal and also provide the access via terminal.
Login on TOS using your admin user and open Terminal.
We'll give access to KavitaOkm application user to folder Books folder in the home folder of user test:

Code: Select all

##KavitaOkm need access to "Books" folder inside the user "test" home folder: /Volume1/homes/test/Books
#test KavitaOkm read access to /Volume1/homes. Access OK
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes"
total 48
drwxr-xr-x+  6 nas   nas   4096 Nov 21 14:03 .
drwxr-xr-x  34 www-data www-data 4096 Nov 20 23:44 ..
drwxrwxrwx+  5 nas   nas   4096 Nov 21 10:08 user2
drwxr-xr-x+ 11 nas   nas   4096 Nov 20 22:54 nas
drwxrwxrwx+  3 nas   nas   4096 Apr 17  2026 super
drwxrwxrwx+  3 nas   nas   4096 Nov 21 14:03 test

#test KavitaOkm access to /Volume1/homes/test. Permission denied
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test"
ls: cannot open directory '/Volume1/homes/test': Permission denied

#Grant read access for KavitaOkm to /Volume1/homes/test.
nas@F2-221:/# tmacltool modify /Volume1/homes/test user:KavitaOkm:allow:r-x---a-R-c--:----

#test KavitaOkm access to /Volume1/homes/test. Access OK
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test"
total 32
drwxrwxrwx+ 2 nas nas 4096 Nov 21 14:03 '#recycle'
drwxrwxrwx+ 4 nas nas 4096 Nov 21 14:04  .
drwxr-xr-x+ 6 nas nas 4096 Nov 21 14:03  ..
drwxrwxrwx+ 2 nas nas 4096 Nov 21 14:04  Books

#test KavitaOkm access to /Volume1/homes/test/Books. Permission denied
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test/Books"
ls: cannot open directory '/Volume1/homes/test/Books': Permission denied

#Grant read/write and inherited access for KavitaOkm to /Volume1/homes/test/Books.
nas@F2-221:/# tmacltool add /Volume1/homes/test/Books user:KavitaOkm:allow:rwxpdDaARWc--:fd--

#test KavitaOkm access to /Volume1/homes/test/Books. Access OK
nas@F2-221:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/test/Books"
total 24
drwxrwxrwx+ 3 nas nas 4096 Nov 21 14:09  .
drwxrwxrwx+ 4 nas nas 4096 Nov 21 14:04  ..
drwxrwxrwx+ 2 nas nas 4096 Nov 21 14:10 'After 20 years'
Add /Volume1/homes/test/Books to library
Image

Image
Hi. Yes, the user KavitaOkm only had access to the “luis” folder, and now I've edited it so that the parent folder “homes” has the permissions shown in the image. However, Kavita still can't view the “luis” folder, so I went to the terminal and showed what I ran there, but even so, Kavita still doesn't have access to the “luis/Media/Comic” folder.

Code: Select all

azorsa@TNAS:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes"
total 0
drwxr-xr-x+ 1 azorsa azorsa   20 Jun  2 20:16 .
drwxr-xr-x  1 azorsa azorsa  154 Nov 21 11:29 ..
drwxrwxrwx+ 1 azorsa azorsa 1072 Nov 21 11:50 azorsa
drwxrwxrwx+ 1 luis   admin    70 Jul 17 00:52 luis
azorsa@TNAS:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/luis"
total 0
drwxr-xr-x+ 1 azorsa azorsa 10 Aug  5 23:50 '#recycle'
drwxrwxrwx+ 1 luis   admin  70 Jul 17 00:52  .
drwxr-xr-x+ 1 azorsa azorsa 20 Jun  2 20:16  ..
drwxr-xr-x+ 1 luis   luis    0 Jul 19 12:40  Desktop
drwxrwxrwx+ 1 luis   luis   78 Aug 18 23:00  Media
drwxr-xr-x+ 1 luis   luis    0 Jun 21 20:58  Photos
drwxr-xr-x+ 1 luis   luis   20 Aug  1 18:35  TerraSync
azorsa@TNAS:/# tmacltool modify /Volume1/homes/luis user:KavitaOkm:allow:r-x---a-R-c--:----
azorsa@TNAS:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/luis"
total 0
drwxr-xr-x+ 1 azorsa azorsa 10 Aug  5 23:50 '#recycle'
drwxrwxrwx+ 1 luis   admin  70 Jul 17 00:52  .
drwxr-xr-x+ 1 azorsa azorsa 20 Jun  2 20:16  ..
drwxr-xr-x+ 1 luis   luis    0 Jul 19 12:40  Desktop
drwxrwxrwx+ 1 luis   luis   78 Aug 18 23:00  Media
drwxr-xr-x+ 1 luis   luis    0 Jun 21 20:58  Photos
drwxr-xr-x+ 1 luis   luis   20 Aug  1 18:35  TerraSync
azorsa@TNAS:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/luis/Media/Comic"
total 0
drwxrwxrwx+ 1 luis luis 2166 Jun  3 18:37  .
drwxrwxrwx+ 1 luis luis   78 Aug 18 23:00  ..
drwxrwxrwx+ 1 luis luis  288 Jun  3 17:41 '100 Balas'
drwxrwxrwx+ 1 luis luis 2452 Jun  3 17:52 'American Vampire'
drwxrwxrwx+ 1 luis luis  102 Jun  3 17:52  Bagdad
drwxrwxrwx+ 1 luis luis  516 Jun  3 17:54 'Bite Club'
drwxrwxrwx+ 1 luis luis  490 Jun  3 17:55 'Blood and Water'
drwxrwxrwx+ 1 luis luis   30 Jun  3 17:55 'Bloody Mary'
drwxrwxrwx+ 1 luis luis  304 Jun  3 17:57 'Brother Lono'
drwxrwxrwx+ 1 luis luis   72 Jun  3 17:57  Cadáveres
drwxrwxrwx+ 1 luis luis  360 Jun  3 17:59 'Chiaroscuro - La Vida Privada de Leonardo Da Vinci'
drwxrwxrwx+ 1 luis luis  936 Jun  3 18:00 'Cinderella - Fábulas para la eternidad'
drwxrwxrwx+ 1 luis luis   26 Jun  3 18:00 'Civil War'
.
.
.
drwxrwxrwx+ 1 luis luis 1208 Jun  3 17:57  Hellblazer
drwxrwxrwx+ 1 luis luis 1546 Jun  3 18:00  Hinterkind
drwxrwxrwx+ 1 luis luis 2280 Jun  3 18:04  IZombie
drwxrwxrwx+ 1 luis luis  552 Jun  3 18:07 'La Cosa del Pantano'
drwxrwxrwx+ 1 luis luis  216 Jun  3 18:08 'Lo mejor de tu vida'
drwxrwxrwx+ 1 luis luis   76 Jun  3 18:08 'Los 10,000 Desastres de Dort'
drwxrwxrwx+ 1 luis luis  560 Jun  3 18:12 'Los invisibles'
drwxrwxrwx+ 1 luis luis  522 Jun  3 18:13  Lucifer
drwxrwxrwx+ 1 luis luis  306 Jun  3 18:15 'Mad Max Furia en la carretera'
drwxrwxrwx+ 1 luis luis  108 Jun  3 18:15  Neverwhere
drwxrwxrwx+ 1 luis luis  122 Jun  3 18:17 'Noche oscura, Una historia verídica de Batman'
drwxrwxrwx+ 1 luis luis  436 Jun  3 18:20 'Patrulla Condenada (Integrales)'
drwxrwxrwx+ 1 luis luis   32 Jun  3 18:21 'Planeta Hulk'
drwxrwxrwx+ 1 luis luis   62 Jun  3 18:21 'Punk Rock Jesus'
drwxrwxrwx+ 1 luis luis  166 Jun  3 18:22 'Sargento Rock'
drwxrwxrwx+ 1 luis luis  618 Jun  3 18:25 'Saucer Country'
drwxrwxrwx+ 1 luis luis  118 Jun  3 17:40  Scalped
drwxrwxrwx+ 1 luis luis  806 Jun  3 17:50  Spawn
drwxrwxrwx+ 1 luis luis 7934 Jun  3 18:10 'Spiderman Coleccion Definitiva'
drwxrwxrwx+ 1 luis luis  192 Jun  3 18:12  Suiciders
drwxrwxrwx+ 1 luis luis  234 Jun  3 18:13 'The Corinthian'
drwxrwxrwx+ 1 luis luis 3188 Jun  3 22:59 'The Preacher'
drwxrwxrwx+ 1 luis luis 1538 Jun  3 18:24 'The Sandman'
drwxrwxrwx+ 1 luis luis  300 Jun  3 18:25 'The Wake'
drwxrwxrwx+ 1 luis luis 2560 Jun  3 18:30 'The Walking Dead'
drwxrwxrwx+ 1 luis luis  276 Jun  3 18:31 'Tom Strong'
drwxrwxrwx+ 1 luis luis   52 Jun  3 18:32 'Tomorrow Stories'
drwxrwxrwx+ 1 luis luis  116 Jun  3 18:33 'Top 10 - The Forty-Niners + Smax'
drwxrwxrwx+ 1 luis luis  138 Jun  3 18:34  Transmetropolitan
drwxrwxrwx+ 1 luis luis   98 Jun  3 18:36 'Una nevera llena de cabezas'
drwxrwxrwx+ 1 luis luis   82 Jun  3 18:36 'V de Vendetta'
drwxrwxrwx+ 1 luis luis   62 Jun  3 18:37  Watchmen
drwxrwxrwx+ 1 luis luis   36 Jun  3 18:37 'World War Hulk'
drwxrwxrwx+ 1 luis luis 3298 Jun  3 18:37 'Y The Last Man'
drwxrwxrwx+ 1 luis luis  108 Jun  3 17:40  Zatanna
azorsa@TNAS:/# tmacltool add /Volume1/homes/luis/Media/Comic user:KavitaOkm:allow:rwxpdDaARWc--:fd--
azorsa@TNAS:/# su -s /bin/sh KavitaOkm -c "ls -la /Volume1/homes/luis/Media/Comic"
total 0
drwxrwxrwx+ 1 luis luis 2166 Jun  3 18:37  .
drwxrwxrwx+ 1 luis luis   78 Aug 18 23:00  ..
drwxrwxrwx+ 1 luis luis  288 Jun  3 17:41 '100 Balas'
drwxrwxrwx+ 1 luis luis 2452 Jun  3 17:52 'American Vampire'
drwxrwxrwx+ 1 luis luis  102 Jun  3 17:52  Bagdad
drwxrwxrwx+ 1 luis luis  516 Jun  3 17:54 'Bite Club'
drwxrwxrwx+ 1 luis luis  490 Jun  3 17:55 'Blood and Water'
drwxrwxrwx+ 1 luis luis   30 Jun  3 17:55 'Bloody Mary'
drwxrwxrwx+ 1 luis luis  304 Jun  3 17:57 'Brother Lono'
drwxrwxrwx+ 1 luis luis   72 Jun  3 17:57  Cadáveres
drwxrwxrwx+ 1 luis luis  360 Jun  3 17:59 'Chiaroscuro - La Vida Privada de Leonardo Da Vinci'
.
.
.
drwxrwxrwx+ 1 luis luis  122 Jun  3 18:17 'Noche oscura, Una historia verídica de Batman'
drwxrwxrwx+ 1 luis luis  436 Jun  3 18:20 'Patrulla Condenada (Integrales)'
drwxrwxrwx+ 1 luis luis   32 Jun  3 18:21 'Planeta Hulk'
drwxrwxrwx+ 1 luis luis   62 Jun  3 18:21 'Punk Rock Jesus'
drwxrwxrwx+ 1 luis luis  166 Jun  3 18:22 'Sargento Rock'
drwxrwxrwx+ 1 luis luis  618 Jun  3 18:25 'Saucer Country'
drwxrwxrwx+ 1 luis luis  118 Jun  3 17:40  Scalped
drwxrwxrwx+ 1 luis luis  806 Jun  3 17:50  Spawn
drwxrwxrwx+ 1 luis luis 7934 Jun  3 18:10 'Spiderman Coleccion Definitiva'
drwxrwxrwx+ 1 luis luis  192 Jun  3 18:12  Suiciders
drwxrwxrwx+ 1 luis luis  234 Jun  3 18:13 'The Corinthian'
drwxrwxrwx+ 1 luis luis 3188 Jun  3 22:59 'The Preacher'
drwxrwxrwx+ 1 luis luis 1538 Jun  3 18:24 'The Sandman'
drwxrwxrwx+ 1 luis luis  300 Jun  3 18:25 'The Wake'
drwxrwxrwx+ 1 luis luis 2560 Jun  3 18:30 'The Walking Dead'
drwxrwxrwx+ 1 luis luis  276 Jun  3 18:31 'Tom Strong'
drwxrwxrwx+ 1 luis luis   52 Jun  3 18:32 'Tomorrow Stories'
drwxrwxrwx+ 1 luis luis  116 Jun  3 18:33 'Top 10 - The Forty-Niners + Smax'
drwxrwxrwx+ 1 luis luis  138 Jun  3 18:34  Transmetropolitan
drwxrwxrwx+ 1 luis luis   98 Jun  3 18:36 'Una nevera llena de cabezas'
drwxrwxrwx+ 1 luis luis   82 Jun  3 18:36 'V de Vendetta'
drwxrwxrwx+ 1 luis luis   62 Jun  3 18:37  Watchmen
drwxrwxrwx+ 1 luis luis   36 Jun  3 18:37 'World War Hulk'
drwxrwxrwx+ 1 luis luis 3298 Jun  3 18:37 'Y The Last Man'
drwxrwxrwx+ 1 luis luis  108 Jun  3 17:40  Zatanna
azorsa@TNAS:/# 

Image

Image
User avatar
outkastm
Gold Member
Posts: 1486
Joined: 29 Dec 2020, 23:52

Re: [ Kavita ] Self-hosted digital book library

Post by outkastm »

Look on this screenshot what you need to choose when you add the library
Should be /Volume1/homes/luis/... and not /homes
/homes contains only onle folder for the superuser account

Image
Post Reply

Return to “Developer Discussion Room”