Calibre Content Server on iPhone & iPad: The Complete Guide

Quick answer: In Calibre on your computer, click Connect/share and choose Start Content Server. Your library is then live at http://<your-computer-ip>:8080/opds. On your iPhone or iPad, add that address as an OPDS catalog in a reader app (justRead can even find it on your Wi-Fi without typing), enter a login only if you set one, and your whole Calibre library shows up ready to download. The single most common mistake is pointing at the bare IP and forgetting the /opds path; the second is a firewall silently blocking port 8080.

This guide was fully rewritten and expanded in July 2026, set up and verified first-hand on a real home Calibre library rather than paraphrased from the manual.

Calibre is the best free way to organize an ebook library, but there is no official Calibre app for iPhone or iPad. The Content Server closes that gap: it serves your entire collection over your network so you can read it on iOS without copying a single file by hand. This guide is specifically about the server itself, how to start it, reach it, unblock it, secure it, and scale it to multiple libraries. If you are still deciding between the Content Server and cloud-folder methods, start with the sync route overview; if you just want the generic OPDS steps for any catalog, see how to set up OPDS on iPhone and iPad.

A note from me: I am Petr Jahoda, and I make justRead. I run a real Calibre library at home and set this exact server up on my own machines, so the steps and the gotchas below are the ones I actually hit.

What the Content Server actually does

The Content Server is a small web server built into Calibre. When you start it, Calibre publishes your library two ways at once, on the same port:

• A browsable web page. Open http://<your-ip>:8080 in any browser and you get a full web reader: search, covers, download links, even an in-browser viewer. This is meant for humans.
• An OPDS feed at http://<your-ip>:8080/opds. OPDS (Open Publication Distribution System) is a catalog format built on Atom/XML that reading apps understand. This is meant for apps.

On iOS the OPDS feed is the part that matters. It lets a reader on your iPhone list every book with covers and metadata, search the whole library, browse by author or tag, and download any title on demand without you ever touching a cable or a file manager.

Both EPUB and PDF files are served, which is what most iOS readers, justRead included, can open. If a book in your library is only in MOBI, AZW3, or another format, convert it to EPUB inside Calibre first (right-click the book, Convert books, output format EPUB); the converted copy then serves cleanly to iOS. There is a short honesty note on formats later on.

The one limitation to internalize before anything else: the server runs only while Calibre is open and the computer is awake. Close Calibre, or let the machine sleep, and the library goes offline. This is a "reading at home while the desktop is on" feature, not an always-on cloud service, unless you take the extra steps in the remote-access section.

Before you start

You need three things:

1. Calibre installed on a Windows, macOS, or Linux computer with your library in it.
2. That computer and your iPhone or iPad on the same Wi-Fi network (for local use).
3. An OPDS-capable reader on iOS. This guide uses justRead for the iOS side because it can auto-discover the server and, if you want it later, sync two ways.

That is it. No account, no cloud service, no cables.

Step 1: Start the server in Calibre

1. Open Calibre on your computer.
2. Click Connect/share in the toolbar.
3. Choose Start Content Server.
4. When your operating system prompts you, allow Calibre through the firewall.

That fourth step is not decoration. On the very first start, Windows and macOS usually pop a firewall dialog asking whether to allow incoming connections for Calibre. If you dismiss it, or it never appears, the server starts but no other device can reach it. If you missed the prompt, jump to the firewall section below before assuming anything is broken.

Make it start automatically. If you use this every day, open Preferences, Sharing over the net and tick Run server automatically when calibre starts. Now the server comes up with Calibre instead of you clicking through the menu each time.

Confirm it is running. Back in Connect/share, the menu entry flips to Stop Content Server once it is live, and the same panel shows the port it bound to. If you ever change settings, use Stop then Start to make the server re-bind cleanly; some changes do not take effect until it restarts.

Step 2: Find the OPDS address

The OPDS endpoint is three parts joined together: your computer's local IP address, the port (default 8080), and the path /opds.

http://192.168.1.10:8080/opds

Replace 192.168.1.10 with your own machine's address.

Find your computer's IP

• Windows: open Command Prompt (press the Windows key, type cmd, Enter), type ipconfig, and press Enter. Read the IPv4 Address under your active Wi-Fi or Ethernet adapter. It usually starts with 192.168. or 10.. Ignore anything under a "Virtual" or "VMware" adapter.
• macOS: open System Settings, click Wi-Fi, then Details next to your connected network. The IP address is listed there. (On older macOS it is under System Preferences, Network.) A shortcut: hold Option and click the Wi-Fi icon in the menu bar; the IP address shows in the dropdown.

Confirm the port

The default is 8080. If you ever need to change it, for example because another app already uses 8080, the port field is in Preferences, Sharing over the net. Whatever number you set there is the number you put in the URL. Change it, restart the server, and update the address on your phone to match.

Make the address stop changing (the DHCP trap)

Home routers hand out IP addresses by DHCP, so your computer's address can change after a reboot or a lease renewal, and the URL that worked last week suddenly fails. This is one of the most common "it broke by itself" complaints. Two fixes make the address permanent:

• Reserve a static IP (recommended). In your router's admin page, find the DHCP or LAN settings, look for Address Reservation or DHCP Reservation, and bind your computer's MAC address to a fixed IP. From then on the router always hands your computer the same address, and your OPDS URL never changes.
• Use the .local hostname instead of a number. Every computer has a name it advertises over mDNS, so you can often use http://my-pc.local:8080/opds instead of the IP. This is built into macOS and available on Windows when Bonjour is installed (it ships with iTunes, for example). If .local does not resolve on your particular network, fall back to a reserved static IP; it is the more universally reliable of the two.

Step 3: Connect from your iPhone or iPad

In an OPDS-capable reader, open the OPDS or Catalogs section, add a new catalog, and paste the address from step 2.

justRead handles this two ways:

• Auto-discovery. On the same Wi-Fi, justRead can find a running Calibre Content Server for you, so the address is filled in and there is often nothing to type at all.
• Manual entry. You can still type or paste the full http://<ip>:8080/opds address yourself, which is what you use for a reserved IP, a .local hostname, or a remote HTTPS setup.

If you enabled a login in Calibre, justRead supports HTTP Digest authentication, so it prompts for the username and password and connects. Once you are in, you can browse the library, run a server-side search, page through large collections, browse by category, and download books to read fully offline.

The /opds path gotcha

This is the number-one reason a connection "half works." If you enter http://192.168.1.10:8080 with no path, you are pointing at the human web page, not the machine-readable feed, and the catalog comes back empty or errors out. The feed lives at /opds. Always include it. Both devices also need to be on the same Wi-Fi for a local address to resolve, and some routers with "AP isolation" or "client isolation" turned on will block devices from seeing each other even on the same network; if nothing on your LAN can reach the server, check for that setting.

Test it in a browser first (the fastest diagnostic)

Before you blame the app, prove the server is reachable. On the same phone, open Safari and go to http://<your-ip>:8080.

• If the Calibre web page loads, the server, the network, and the firewall are all fine, and the problem is only in how you entered the OPDS address (almost always the missing /opds).
• If Safari cannot connect at all, the server is not reachable from the phone yet, which points at the firewall or a wrong IP, not the app. Go to the firewall section.

This 15-second test saves people from reinstalling apps that were never the problem.

Fix the port 8080 firewall block

If everything looks right but the phone still cannot connect, and the browser test above also fails, the firewall is almost always the culprit. This is the single most common failure, so it gets full detail for both systems.

Windows

1. Press the Windows key, type Windows Defender Firewall, and open it.
2. Click Allow an app or feature through Windows Defender Firewall on the left.
3. Click Change settings (you may need administrator rights).
4. Find calibre in the list and tick both Private and Public for your network. On a home network, Private alone is enough, and leaving Public unticked is safer.
5. If calibre is not in the list, click Allow another app, then Browse, and select calibre.exe (usually in C:\Program Files\Calibre2\). Add it, then tick the boxes.
6. Click OK.

If you run a third-party security suite (Norton, McAfee, Bitdefender, Kaspersky, and similar), it often has its own firewall separate from Windows Defender, and that one also needs to allow calibre or permit inbound traffic on port 8080. Windows Defender being open is not enough if a second firewall is quietly blocking.

macOS

1. Open System Settings, go to Network, then Firewall.
2. If the firewall is off, the server is not being blocked by macOS and you can look elsewhere.
3. If it is on, open Options, make sure calibre appears in the list and is set to Allow incoming connections, then save. If calibre is not listed, add it with the + button.
4. On older macOS, this lives under System Preferences, Security & Privacy, Firewall, Firewall Options.

After allowing it

Stop and restart the Content Server from Calibre's Connect/share menu so it re-binds, then re-run the browser test. If the web page now loads on the phone, you are done.

A quick honesty note on formats

The Content Server serves your books as they are stored. justRead opens EPUB and PDF. If a title is only in MOBI, AZW3, FB2, DJVU, or a comic format, it will appear in the catalog but will not open on iOS in an EPUB/PDF reader. The fix lives in Calibre itself: select the book, choose Convert books, set the output to EPUB, and the converted copy serves cleanly. Do the conversion once on the desktop, where Calibre is strongest, and your whole library becomes iOS-friendly.

Secure it and reach it from outside the house

On your own home network a login is optional and everything above just works. The moment you want to reach the library from outside, security stops being optional, and iOS adds a hard rule you cannot ignore.

Add a username and password

In Calibre, go to Preferences, Sharing over the net, enable Require username and password, and create an account (there is a small user manager for adding one or more logins). Readers with credential fields, justRead included, will then prompt for it and connect over HTTP Digest auth. Do this before you expose the server anywhere beyond your own LAN.

The iOS rule that decides your remote setup

iOS will not connect to a remote server over plain HTTP, and it rejects self-signed or untrusted certificates unless you install and explicitly trust a configuration profile. That single constraint rules out the naive "forward port 8080 and type my public IP" approach on iPhone and iPad. For remote access you need one of the following, and they trade off differently:

Option A: A VPN back into your home network (simplest, most private).
Run a VPN so your phone behaves as if it were on your home Wi-Fi, then use the same local http://<ip>:8080/opds address you already have. Because the traffic rides an encrypted tunnel and stays "local," plain HTTP is fine and you never open a port to the public internet. A mesh VPN like Tailscale or a self-hosted WireGuard server makes this a small job.

• Trade-offs: the VPN must be connected on the phone when you want your books, and there is a client to install and keep running. Nothing is publicly exposed, which is exactly why this is the safest option for most people.

Option B: A reverse proxy with real HTTPS (best for browser-and-app access from anywhere).
Put a reverse proxy (Caddy, nginx, or Apache) in front of Calibre, terminate HTTPS there with a valid certificate, and point a domain name at your home. Caddy is the least painful because it obtains and renews a free Let's Encrypt certificate automatically. Your OPDS address then becomes something like https://library.example.com/opds, which iOS accepts.

• Trade-offs: you need a domain, your home IP usually changes so you need Dynamic DNS to keep the domain pointed at it, and you are now publishing a public endpoint that you must keep patched and password-protected. Calibre supports running behind a reverse proxy, including a URL prefix, so this is a documented setup rather than a hack.

Option C: A tunnel service (no open ports, quick to stand up).
A service like Cloudflare Tunnel exposes your Content Server at an HTTPS hostname without opening any inbound port on your router, by running a small outbound agent on your computer.

• Trade-offs: your traffic routes through the provider, and you depend on their agent and account. In return you get HTTPS and no port-forwarding.

About non-standard ports

Changing the external port away from 8080 reduces automated scan noise, and it is a reasonable hardening step inside an HTTPS setup. It is not a substitute for HTTPS: an obscure port over plain HTTP still will not work from iOS and still is not secure. Treat the port change as a minor extra, not the plan.

What not to do

Never forward naked port 8080 to the internet with no HTTPS and no password. That puts your entire library, and a running server, in front of anyone who scans for open ports. If you take one thing from this section: require a login, use HTTPS or a VPN, and never expose plain 8080.

Multiple libraries over one server

If you keep more than one Calibre library, the Content Server handles them together. The top level of the /opds feed shows a picker for each library you have opened in Calibre, and you drill into whichever one you want. You can also restrict which libraries the server shares in Preferences, Sharing over the net if you want to keep some private.

In justRead you can add each library as its own server entry and keep them side by side, with per-server filtering so a search or a sync touches only the library you meant. That keeps a big fiction library and, say, a technical-PDF library from bleeding into each other.

Keeping it on without babysitting the desktop

Because the built-in server dies when Calibre closes, people who want the library reachable around the clock usually move up one of two steps. Both are optional and bigger projects:

• Headless Calibre server. Calibre ships a command-line server, calibre-server, that serves a library without opening the full GUI. Point it at your library folder and it runs as a lightweight service, which is handy on a spare machine or a home server.
• calibre-web or COPS. These are separate, community-built web apps that read your Calibre library and stay on independently of the desktop Calibre. They are the common answer when "the computer and Calibre must stay open" is a dealbreaker. They are extra software to install and maintain, so reach for them only when always-on access is a genuine daily need.

Read-only browsing vs two-way sync

Here is the honest boundary, and it is the most important trade-off to understand.

OPDS over the Content Server is read-only: you browse and download, and that is the whole feature. That is perfect when all you want is your books on your phone. What it cannot do is send anything back. Your reading progress, your ratings, and your finished dates stay trapped on the phone, and Calibre never learns you read the book.

justRead's Calibre sync is built on the exact same Content Server connection, but adds two-way sync on top of it. It writes reading progress, star ratings, want-to-read flags, finished dates, session counts, and reading stats back into Calibre, and it imports your ratings, progress, finished state, and custom columns on the way in. New, Changed, and Synced badges show each book's state at a glance, Select New & Changed grabs just the delta instead of re-downloading everything, syncs run in parallel with the screen kept awake so they finish, and a post-sync log plus a 10-day history tell you exactly what moved, PDFs included. Re-syncing preserves your position, bookmarks, and highlights rather than overwriting them.

In short: plain OPDS when you only want to read; two-way Calibre sync when you want your computer and phone to agree on where you are in every book.

Full troubleshooting matrix

• Nothing loads at all. Confirm Calibre is open, the Content Server actually says "Stop Content Server" (meaning it is running), both devices share one Wi-Fi network, and the address ends in /opds, not the bare IP. Run the Safari browser test to isolate app vs network.
• The web page loads in Safari but the app shows nothing. You dropped the /opds path, or you typed the port wrong. Fix the address in the app.
• Safari cannot connect either. Firewall or wrong IP. Allow calibre through the firewall on the host, restart the server, and re-check the IP with ipconfig or System Settings.
• It worked, then broke a few days later. Your computer's IP changed on DHCP. Reserve a static IP in your router, or switch the URL to the machine's .local hostname.
• Devices are on the same Wi-Fi but still cannot see each other. Your router may have AP/client isolation enabled, or you are on a "Guest" network that isolates clients by design. Move both devices to the main network and disable isolation.
• It suddenly asks for a login. You enabled authentication in Calibre's Sharing over the net settings. Enter those credentials in the app, or turn the requirement off for home-only use.
• A book shows in the catalog but will not open on iOS. It is probably a non-EPUB, non-PDF format. Convert it to EPUB in Calibre and re-download.
• Remote access over HTTPS fails. iOS is rejecting a self-signed, expired, or hostname-mismatched certificate, or you are still on plain HTTP. Use a valid certificate through a domain and reverse proxy, or connect over a VPN instead.
• Remote access works in a browser but not the app. Confirm the app is pointed at the HTTPS OPDS URL (https://.../opds), not the plain-HTTP LAN address, and that the certificate is fully trusted by iOS.
• It only works when I am at my desk. The Content Server lives inside Calibre, so the computer must stay awake and Calibre must stay open. Disable sleep on the machine, or move to a headless calibre-server, calibre-web, or COPS for around-the-clock access.
• Port 8080 is already in use. Another app grabbed it. Change the port in Preferences, Sharing over the net, restart the server, and update the phone's address.

Put your whole library on your phone

The Content Server is the simplest way to get a large Calibre library onto an iPhone or iPad without duplicating files or fighting with cables. Set it up once, mind the /opds path and the firewall, pin the IP so it stops changing, and every book you have organized is a tap away. For the wider world of catalogs and servers, see the OPDS reader overview; to keep your progress in sync across devices, the Calibre sync workflow.

Download justRead on the App Store and connect your Calibre Content Server in minutes.