Troubleshoot Nextcloud Deck,
from server errors to stuck sync.
Most problems come from the server URL, sign-in, the Deck app, permissions, or reachability. Start with the error code.
Last verified
01
Server errors and what they mean
The HTTP status code points to the cause. The server log and the web interface confirm it.
| Error | Usual cause | Fix |
|---|---|---|
| 503 Service Unavailable | Nextcloud is in maintenance mode, usually during or after an update. The web interface shows the same page. | An administrator finishes the update with occ upgrade, then runs occ maintenance:mode --off. |
| 401 Unauthorized | The app password no longer works, for example because it was revoked in Nextcloud's security settings. Deckloud shows Sign-in expired. | Sign in again with Login Flow. With two-factor authentication, use Login Flow or a new app password. |
| 403 Forbidden | The account may not do this on that board, or a reverse proxy or firewall blocks the request. Deckloud shows Permission denied. | Try it in the web interface with the same account. If it works there, check the proxy or firewall. |
| 404 Not Found | The Deck app is disabled, the server URL lacks a subpath such as /nextcloud, or the board or card was deleted. | Enable Deck under Apps, copy the base URL from the browser, then refresh. |
| 429 Too Many Requests | Brute-force protection throttles the IP address after repeated failed sign-ins. Deckloud shows Rate limit reached. | Wait, then sign in once with the right account. An administrator can also run occ security:bruteforce:reset followed by the IP address. |
| Certificate error | The TLS certificate is self-signed, expired, or issued for another hostname. | Use a certificate the device trusts; the self-signed certificate guide shows how. |
02
The five checks that solve most cases
First, check in the phone's browser that Deck shows your boards. If it fails there, the cause is on the server, and no client can fix it.
1. Server URL.
Use the exact base URL, with https and any subpath such as example.com/nextcloud. A www or http mismatch is the most common login failure.
2. Authentication.
Sign in with Nextcloud's Login Flow, or with an app password from Personal settings > Security. Both work with two-factor authentication.
3. Deck app on the server.
An admin must install and enable Deck on the server.
4. Permissions.
Missing boards or failed board creation usually come from sharing or group permissions, not sync. Try the same action in the web app with the same account.
5. Reachability.
A server behind a VPN, a local-only DNS name, or a strict reverse proxy can work at your desk and fail on mobile data. Test the URL in the phone's browser on the same connection.
03
When sync is the issue
Deckloud shows the last successful sync and keeps offline changes in a visible queue. If edits are stuck, check that the server is reachable and retry. A 4xx error on one change, often permissions or a deleted card, differs from an unreachable server.
04
Self-signed certificates and reverse proxies
A self-signed certificate or unusual proxy headers can pass in a desktop browser and still fail on iOS, which enforces stricter transport rules. A Let's Encrypt certificate for the public hostname is the simplest fix.
FAQ
Practical questions
Deckloud shows no boards after login. Why?
Usually Deck is not enabled on the server, the account has no boards, or you signed in to another server or account.
Why do changes from the web app take a moment to appear?
Deckloud syncs when you open it and at regular intervals. Pull to refresh to sync now.
Where do I find something to send with a bug report?
In Settings > Diagnostics, choose Copy summary or Export diagnostics. Both hold sync state and recent errors, but no board content.
What does Nextcloud maintenance mode mean?
Nextcloud answers every request with 503, usually during an update. If it stays on, an administrator runs occ upgrade, then occ maintenance:mode --off.
Related
Nextcloud Deck, from server app to daily workflow.
Nextcloud Deck is a kanban app for your Nextcloud server. Learn how boards, stacks and cards work, what you need to start, and which apps and guides help.
OpenNextcloud Deck login on iPhone, and why sign-in fails.
Troubleshoot Nextcloud Deck login on iPhone with server URL, Login Flow v2, app passwords, and Deck app availability checks.
OpenNextcloud Deck not showing boards: four causes, in order.
Boards missing in the Nextcloud Deck app? Check these in order: Deck app disabled on the server, wrong account or server URL, board not shared, then sync.
OpenFix the Nextcloud self-signed certificate error on iPhone.
Nextcloud works in the browser but the iPhone app fails? Trust your own CA in iOS settings or use a free Let's Encrypt certificate, even on a LAN-only server.
OpenNextcloud Deck offline sync recovery, with plain recovery states.
Understand offline queueing, retry, last successful sync, and recovery expectations for Nextcloud Deck in Deckloud.
Open