How to proper setup Nextcloud Notes in koreader?

[eddierm]

Hi everyone!

I have been using koreader for long time now and found it very useful for my academic work. I used to export all my highlights to joplin but in version 2024.11 I found there are a new option: Nextcloud Notes. Since I have a selfhosted server with NC which I use as a replacement for Google Drive, I find this option interesting.

In the wiki at Koreader's Github page, there is no documentation to setup Nextcloud Notes, so I did the next steps:

In highlight export select Nextcloud Notes and configure like this:

URL: https://myserver.tld/nextcloud
Username: my-nc-user
App Password: 11111-22222-33333-44444-55555

Just for clarification, my NC server is not on a subdomain but in a subfolder (/nextcloud).

What I tried:

1. Using my normal NC password. Did not work!
2. Create an app password in NC -> Config -> Security. Then i used the 5 blocks of 5 characters each in the password (as my example). Did not work!
3. Remove the hyphens and put the 25 characters continue. Did not work!
4. Add a slash after the url: https://myserver.tld/nextcloud/ with the app password both with and without hyphens. Did not work!
5. Add the complete address to Nextcloud Notes: https://myserver.tld/nextcloud/apps/notes with the app password both with and without hyphens. Did not work!

I would like to ask you if someone knows how to setup Nextcloud Notes with koreader and could help me.

Thanks in advance!

[pazos]

Yup. I merged the feature without documentation

Hopefully somebody helps:

You'll need the url of your nextcloud instance, like "https://nc.example.com" or "https://example.com/nc", your user name within that nc instance and an app password from "NC-> Security -> Devices & sessions"

If that stills fails you'll need to look at the logs and tell us what happens.

There's no reason for it to not work with a subdomain if your nginx/apache proxy is configured properly.

Nextcloud has a tool on its web UI to check about misconfigurations, make sure there's no problem on reverse proxy if you're using Nextcloud AIO kind of solutions.

[eddierm]

Hello there and thanks for your fast reply.

I have made as you said (I have already done it from the beginning), but still do not work. As I said in my first post, I made an app password in NC and that is correct.

My server is on Nginx and, as I said before, NC is fully functional since I used it well on my web browser and the NC desktop app (in Windows 10).

This are my logs in koreader, but I do not understand what it means:

11/21/24-22:03:03 WARN Nextcloud: HTTP response code <> 200. Response status: HTTP/1.1 401 Unauthorized
11/21/24-22:03:03 WARN Error fetching existing notes from Nextcloud HTTP/1.1 401*Unauthorized

I have seen the NC logs but I did not find any relevant in that time.

What checks can I do?

Originally Posted by pazos

Yup. I merged the feature without documentation

Hopefully somebody helps:

You'll need the url of your nextcloud instance, like "https://nc.example.com" or "https://example.com/nc", your user name within that nc instance and an app password from "NC-> Security -> Devices & sessions"

If that stills fails you'll need to look at the logs and tell us what happens.

There's no reason for it to not work with a subdomain if your nginx/apache proxy is configured properly.

Nextcloud has a tool on its web UI to check about misconfigurations, make sure there's no problem on reverse proxy if you're using Nextcloud AIO kind of solutions.

[pazos]

Thanks for your feedback, eddierm!

I'll need some free time. Give me a few weeks. Until then you can keep exporting to joplin. Eventually joplin will be removed as the setup is pretty involved and joplin itself isn't still designed for this usercase.

Don't worry, we won't drop joplin until we make sure the nextcloud exporter is in good shape.

Let me know if you have PM's enabled. Once I double check everything works fine here I'll send you a message with temporal credentials on my own instance, so you can test it works on your end.

Ademas, por privado, podemos hablar en nuestra lengua materna

[eddierm]

Hi again @pazos Is there any update about how to use Nextcloud Notes in Koreader? I tried again and I am getting the same errors.

[pazos]

Originally Posted by eddierm

Hi again @pazos Is there any update about how to use Nextcloud Notes in Koreader? I tried again and I am getting the same errors.

Everything works fine here, for quite a long time. I've received feedback on github. Nobody seem to have your particular issue.

Please send me a PR with login credentials to your nextcloud instance (and its endpoint) so I can double check if it is indeed related to your particular configuration.

[Uncle Robin]

Rather than start a new thread I'm posting here because I too am having trouble getting Nextcloud (free shared hosting provide setup via Nextcloud's website) setup

The attachments show the app password from nextcloud and my attempt to enter that info into KOReader. I copied the login details and pasted into Notepadd++ then into the reader settingslua on my KOReader to avoid typos.

The error message in the crash log is
WARN Error fetching existing notes from Nextcloud Server HTTP response code is not OK

I tried modifying the URL to
https://tio.lv.tab.digital/apps

but that made no difference to the result. What am I doing wrong

[eddierm]

Originally Posted by pazos

Everything works fine here, for quite a long time. I've received feedback on github. Nobody seem to have your particular issue.

Please send me a PR with login credentials to your nextcloud instance (and its endpoint) so I can double check if it is indeed related to your particular configuration.

Hi again.

I think I am not the only one with the same issue. I recently noted that someone documented the section of nextcloud notes on the koreader wiki, but he says this plugin simple does not work:

https://github.com/koreader/koreader...extcloud-notes

EDIT:

I finally got it working!

NC app bruteforece was banning my kobo IP address so I had to whitelist my kobo local IP address in NC->Config->Security. After that i deleted my Token and created a new one. Finally i got connected and I could upload one book notes... BUT...

When I tried to upload another book notes it did not work. So I tried to upload all my books notes and keep crashing. This is what I got on koreader crash log:

05/21/25-10:21:09 WARN Error fetching existing notes from Nextcloud Unable to decode JSON: Missing a closing quotation mark in string. (14330)

Interestingly, it is the same error when I try to upload notes from different books, the only change is the las number in parenthesis:

First book was: (4958)
Second book: (23929)
When I tryed to upload all books notes was (14330)

What those it mean? Sholud i upload it as an issue in github?

Please @pazos tell me what to do... And thanks a lot for your help!

[pazos]

Originally Posted by eddierm

Should I upload it as an issue in github?

No need. Just keep an eye on https://github.com/koreader/koreader/issues/13623 and try again the first nightly release after the issue is closed.

[shtrom]

Just a note, as this confused me and sent me on the wrong track:

Originally Posted by eddierm

App Password: 11111-22222-33333-44444-55555

What I tried:

1. the app password both with and without hyphens. Did not work!

The App Password _needs_ the hyphens. Otherwise you'd get a PasswordLoginForbidden from Nextcloud. Not because of MFA or BruteForce settings, but just because the password is incorrect.

[Uncle Robin]

I now have Nextcloud Notes up and running on my phone, so I I thought I'd try again to get the KOReader export working before my Readwise free trial expires. I'm getting a DIFFERENT error message now, as the attached crash log shows. Nextcloud still seems like a more straightforward solution than setting up WebDav, so if there's any way I can get this sorted, I'm all ears.