[Readeck] Bookmark manager

Readeck for YunoHost

Install Readeck with YunoHost

Overview

Readeck is a simple web application that lets you save the precious readable content of web pages you like and want to keep forever.

Shipped version: 0.12.0~ynh1

Screenshots

Screenshot of readeck

Documentation and resources

3 Likes

Can I install it or will it break my YH?

Why don’t you try and let us know? :sweat_smile:

1 Like

Well, because I don’t want to break my poor YH install. I am not that good in solving problems when they occur :-), so I will wait…

Thank you anyway for Readeck in YH.

Great app! Wallabag has no mobile firefox extension that still allows you to save articles behind a firewall. Readeck with mobile expansion has solved the problem!

What doesn’t work for me: connection with OPDS.

Has that already worked for someone?

Could this be the problem:

"I Solved a Similar Problem (Docker, Password OtherWise Recognized, App Thinking It’s Not) by Updating My Compose File to Include Readeck_use_X_forwarded as Now Indicated in the doc.

As i understand it, without that environment variable, readeck was not aware of the https reverse proxy. So it was OtheWise Authenticcating on My server https address, then redirecting to the http one, where the authentication wasn’t valid, hence a loop of http 401."

https: codeeberg.orgreadeckreadeckreadeckissues88

Thanks for the app!

We already have these settings on the config.toml file…

use_x_forwarded_for = true
use_x_forwarded_host = true
use_x_forwarded_proto = true

according to the doc that should correspond to the READECK_USE_X_FORWARDED env variable.

UseXForwardedFor   bool          `json:use_x_forwarded_for env:READECK_USE_X_FORWARDED`|
UseXForwardedHost  bool          `json:use_x_forwarded_host env:READECK_USE_X_FORWARDED`|
UseXForwardedProto bool          `json:use_x_forwarded_proto env:READECK_USE_X_FORWARDED`|

Thanks for the quick reply. I find the three variables with this value in the config.toml. Then that was probably a wrong path.

I have now tried the OPDS function of koreader and various Android eBook reader apps. There is no connection possible. Credential error.

Have you ever successfully managed that?

Here are the logs for trying to access the opds catalog:

Mar 15 22:50:01 [URL redacted] readeck[115184]: {"time":"2025-03-15T22:50:01.050984353+01:00","level":"INFO","msg":"http 401 Unauthorized","@id":"[URL redacted]/2cQksMyzvx-000076","request":{"method":"GET","path":"/opds","proto":"HTTP/1.0","remote_addr":" [URL redacted]"},"response":{"status":401,"length":12,"elapsed_ms":0.312024}}

I I tried to debug a bit with Deepseek (:-D) and tried a curl question:

curl -v -u “Username: Password” https://url/opds

I think that’s the crucial part of the answer:

Http/2 401
server: nginx
Date: Thu, 20 Mar 2025 07:56:57 GMT
Content-Type: Text/Plain; Charset = UTF-8
Content-Length: 12
X-SSO-WAT: You’ve Just Been Ssoed

It seems as if the SSO was addressed by Yunohost and not the Readeck, the app.

Deepseek says that most OPDS services want a basic auth method. It says:

To resolve this, the user should check if the opds endpoint requires bypassing SSO. They might need to configure nginx to allow basic auth specify for the /opds path, excluding it from sso.

Its solution for /etc/nginx/conf.d/URL.d/APPNAME.conf

Location /OPDS {
Auth_Basic “Readeck Opds”;
auth_basic_user_file /etc/yunohost/apps//.htpasswd;
proxy_pass http://127.0.0.1:PORT;
proxy_set_header host $ host;
Proxy_set_Header X-Real-ip $ remote_addr;
Proxy_set_Header X-Forwarded-Proto $ Scheme;
… more proxy settings
}

And then with .htpasswd, store a password for the user name.

If I follow this, I unfortunately get a “500 internal server error” for the OPDS URL

But is that the right way at all?

I have upgraded the app to 0.18.2~ynh1 and got still the problem to connect to the opds catalog.

But also I still don’t know if this is my private problem :smiley: