Can't connect to Paperless-ngx probably self-signed SSL

[magenbrot]

The problem

Hi,
my paperless-ngx instance is running behind a nginx proxy with a self-signed SSL certificate. I can't add it to Home Assistant ("Ungültiger Hostname oder IP-Adresse").

Could you add some "disable SSL verification" checkbox when adding this integration? Other options would be to add my self-signed CA certificate to my home assistant trust store, but I think thats not supported.

Best regards
Oli

What version of Home Assistant Core has the issue?

core-2025.6.0

What was the last working version of Home Assistant Core?

No response

What type of installation are you running?

Home Assistant OS

Integration causing the issue

Paperless-ngx

Link to integration documentation on our website

https://www.home-assistant.io/integrations/paperless_ngx

Diagnostics information

No response

Example YAML snippet

Anything in the logs that might be useful for us?

running curl from a SSH shell of home assistant shows:

curl https://paperless.home.ovtec.it/   
curl: (60) SSL certificate problem: self-signed certificate in certificate chain
More details here: https://curl.se/docs/sslcerts.html

curl failed to verify the legitimacy of the server and therefore could not
establish a secure connection to it. To learn more about this situation and
how to fix it, please visit the webpage mentioned above.

Additional information

No response

[home-assistant]

Hey there @fvgarrel, mind taking a look at this issue as it has been labeled with an integration (paperless_ngx) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of paperless_ngx can trigger bot actions by commenting:

• @home-assistant close Closes the issue.
• @home-assistant rename Awesome new title Renames the issue.
• @home-assistant reopen Reopen the issue.
• @home-assistant unassign paperless_ngx Removes the current integration label and assignees on the issue, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component) to the issue.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component) on the issue.

_{^{(message by CodeOwnersMention)}}

---

paperless_ngx documentation
paperless_ngx source
_{^{(message by IssueLinks)}}

[fvgarrel]

Hey @magenbrot,
Do you have any logs from the Paperless integration in Home Assistant (errors, warnings, etc.)?
What paperless version are you using?

[magenbrot]

there are no errors in Home Assistant logs.

I could successfully add the integration while using the IP and exposed port of my paperless docker installation (HTTP only, the same the nginx proxy is using).

[foxcris]

I can confirm the issue. I cannot setup the integration using a certificate signed by my own ca. Also no errors in the Home Assistant logs.

[fvgarrel]

I will check this over the weekend. Thanks for the confirmation @foxcris.

[fvgarrel]

@joostlek What do you think about this? How do you usually handle self-signed certificates?
I could (optional) overwrite the default SSL context for this case. Is that something we do in Home Assistant?

[magenbrot]

@fvgarrel you can refer to the immich integration. It has an option for untrusted SSL certificates.

https://github.com/home-assistant/core/tree/dev/homeassistant/components/immich

[fvgarrel]

Closed by merged PR.

[fvgarrel]

@home-assistant close