Technical Anshu
Tutorials Blog
HTTPS Explained

Why Nextcloud and OnlyOffice Need HTTPS to Work Together

Nextcloud is secure, the editor address is not - and the browser quietly kills the editor. Why both servers need real HTTPS, explained without jargon.

By Technical AnshuLinux ServerSelf HostedBefore you connect
Watch the full video - Nextcloud and OnlyOffice setup and integration, step by step

Here is the trap in one line: Nextcloud on HTTPS plus OnlyOffice on HTTP equals a blocked editor, and nothing inside either program is broken. This page explains the browser rule behind it, the two-subdomain fix, and why certificates also matter for the traffic between the servers themselves.

What the browser does when the two addresses do not match in security
Nextcloud HTTPS + Docs HTTPSEDITOR LOADS
Nextcloud HTTPS + Docs HTTPBLOCKED MIXED CONTENT
Docs HTTPS with bad certificateSERVER REFUSES
The page loads fine - it is the editor frame inside the page that the browser kills.
Example combinations and what each one does - the middle row is the classic trap
1

The Mixed Content Rule, In Plain Words

OnlyOffice does not open as a separate website - its editor loads inside the Nextcloud page, in a frame, from the Docs server's address. Browsers enforce a strict rule: a secure HTTPS page may not load active content from an insecure HTTP address. So if Nextcloud is on https:// and the connector points at http:// for the editor, the browser silently blocks the editor. Nextcloud itself looks healthy, which is why people hunt for the fault in the wrong server for days.

This is not an OnlyOffice bug and no setting inside Nextcloud can switch the browser rule off. The only fix is to serve the Docs server over HTTPS too.

2

The Practical Way - Two Subdomains, Two Certificates

  1. Give each service its own name: cloud.example.com and office.example.com, both pointing at your server.
  2. Put a reverse proxy (Nginx or Apache) in front, one virtual host per name, and let it route to Nextcloud and to the Docs container or service behind it.
  3. Get a free Let's Encrypt certificate for each name, or one wildcard certificate, and turn on automatic renewal.
  4. Update the connector: the Document Editing Service address must be the https://office.example.com/ address, then save and re-test a document.
3

Certificates Matter Between the Servers Too

It is not only the browser. When the Docs server calls back to Nextcloud to deliver your edited file, it checks Nextcloud's certificate. A self-signed certificate on Nextcloud makes the callback fail even when the browser is happy (browsers let a human click through a warning; a server program does not). This is the second classic trap: it works for the admin who accepted the warning once, and fails for everyone else.

Honest advice: on anything beyond a throwaway test, use real certificates on both names from the start. The half hour it takes saves days of strange half-working behaviour.

4

What About a Pure LAN Setup With No Domain

If the system truly never leaves the office network, you can run both over HTTP with IP addresses - but understand the trade: logins and documents travel unencrypted on your LAN, browsers nag, and the day someone wants access from home you rebuild the addressing anyway. A cheap domain plus Let's Encrypt is the better foundation even for LAN-first offices. If you must self-sign, expect the server-to-server trust problem above and budget time for it.

Watch the Complete Video Guide

The video sets the services up on proper addresses - note the HTTPS addresses used when the connector is filled in.

Watch Full Video
Common Questions (FAQ)

Can I disable the mixed content block in the browser?

Not as a real solution - modern browsers do not offer a supported switch for this on normal sites, and per-user workarounds are not something you can roll out to a team. Serve the Docs server over HTTPS; that is the actual fix.

Do I need a separate certificate for the OnlyOffice subdomain?

Each HTTPS name needs a certificate that covers it - either one certificate per subdomain (Let's Encrypt is free) or a single wildcard certificate for the whole domain. Both patterns work fine behind one reverse proxy.

Everything is HTTP on my LAN and it works. Should I change?

For a closed office LAN it functions, but traffic including logins is unencrypted and you will rebuild addressing the day remote access is wanted. Moving to real domains with certificates early is far cheaper than migrating a working office later.

This guide is based on the Technical Anshu video on Nextcloud and OnlyOffice integration. Stuck on a step? Ask in the video comments - you will get an answer there.