Setting Up Nextcloud in Korvex

Korvex stores your job files in your own Nextcloud. Backups go into your account, photos and videos for a job go into a folder for that job, and when you send a client a link, that link points at your server — not somebody else’s.

This guide connects the two. It takes about ten minutes and amounts to copying three pieces of information out of Nextcloud and into Korvex.

You need a Nextcloud account first. If you do not have one, start with How to Set Up Nextcloud on a Windows PC, which covers both running your own server and signing up with a paid host. Either works here — Korvex does not care where your Nextcloud lives.

Step 1 — Find your Nextcloud username

Already comfortable here? Jump to Step 2.

This trips people up more than anything else in this guide, so it is worth thirty seconds.

Nextcloud gives every account two names: a display name, which is what other people see (“Kev Smith”), and a username — Nextcloud calls it the user ID — which is what the system uses internally (kev, or sometimes a long string of letters and numbers).

Your WebDAV address contains the username, not the display name. If you sign in with an email address, your username may well be something different again.

To find it, click your avatar in the top-right corner of Nextcloud and choose Personal settings. The username appears under your profile picture and again in the address bar; some hosted providers label it “Login name”. Write it down exactly as shown — capitalisation matters.

Step 2 — Find your WebDAV address

Already comfortable here? Jump to Step 3.

WebDAV is the standard protocol Korvex uses to put files into your Nextcloud and pull them back out. Every Nextcloud has a WebDAV address, and Nextcloud will show you yours rather than making you build it by hand.

  1. Open Files in Nextcloud (the folder icon in the top bar).
  2. At the very bottom of the left sidebar, click Files settings.
  3. At the bottom of that panel is a WebDAV address with a copy button. Copy it.

You will get something in this shape:

https://cloud.yourdomain.com/remote.php/dav/files/kev/

That is your server address, then /remote.php/dav/files/, then your username from Step 1, then a trailing slash. Check three things before moving on:

  • It starts with https://, not http://. Without the S, your password and files travel unencrypted.
  • It ends with a slash. Paste it into Korvex exactly as copied.
  • The username matches Step 1, capitals included.

Quick sanity check: paste the URL into a browser. You should be asked to log in and then see a bare XML page or a plain file listing. That is WebDAV answering correctly — it is meant to look unfriendly. A 404 page means the URL is wrong.

Step 3 — Create an app password

Already comfortable here? Jump to Step 4.

Do not give Korvex your actual Nextcloud password. Generate a one-off password that only Korvex uses. It is better in three ways: you can revoke it on its own if you lose your phone, it does not change when you change your real password, and it is the only thing that works if you have two-factor authentication turned on.

  1. Avatar (top right) > Personal settings > Security.
  2. Scroll to Devices & sessions.
  3. In the App name box type something you will recognise later — Korvex, or Korvex - work phone if you will connect more than one device.
  4. Click Create new app password.
  5. Nextcloud shows a long password in groups of letters. Copy it now. Once you close that box it is gone for good and you would have to generate a new one.

Nextcloud also displays a username alongside the generated password. It should match Step 1 — use that one if there is any disagreement.

Step 4 — Check that link sharing is allowed

Already comfortable here? Jump to Step 5.

Korvex share links use Nextcloud sharing, which is on by default — but administrators can restrict it and a few hosted providers ship with restrictions in place. If you self-host, take a moment to confirm.

Go to avatar > Administration settings > Sharing (visible only to admins) and check:

Setting Why it matters
Allow apps to use the Share API Must be on. This is the one Korvex needs. With it off, uploads still work but link creation fails.
Allow users to share via link and emails Must be on, or there are no public links at all.
Enforce password protection If on, every link must have a password — so set one in Korvex each time you share.
Set / enforce default expiration date If enforced, links expire on the server schedule regardless of what you choose.

The last two are not problems, just behaviour worth knowing about before a client tells you the link stopped working. On managed hosting these are already enabled and generally cannot be changed — nothing to do.

Step 5 — Enter the details in Korvex

Open Korvex, go to Settings, and tap Cloud Sync. It asks for three things, all of which you now have — and note the reminder at the top of that screen: use a Nextcloud app password, not your account password.

The Korvex Cloud Sync screen with Server WebDAV URL, Username and App password fields
The Cloud Sync screen in Korvex. The Sync controls below the fields become useful once the connection is saved.
Field What to enter From
Server WebDAV URL https://cloud.yourdomain.com/remote.php/dav/files/kev/ Step 2
Username Your Nextcloud username Step 1
App password The generated password Step 3

Paste rather than type. App passwords are long, and one wrong character produces a login error that looks identical to a wrong username. Two more things worth getting right here:

  • Username means your Nextcloud user ID, not your display name. If you put “Kevin Covey” where the server expects kevin, the login is rejected. This is the single most common mistake on this screen — see Step 1.
  • The URL must be the whole address, all the way through /remote.php/dav/files/yourname/. The field is narrower than the address, so it will look truncated once pasted. That is only the display; tap into the field and press End to check the tail.

Tap Test connection first — Korvex signs in and confirms it can write to your account — and then tap Save. They are two separate buttons; testing alone does not store the details.

Why the URL includes your username. Korvex talks to two parts of Nextcloud. Files go through WebDAV, which lives under /remote.php/dav/files/ plus your username. Share links are created through a separate interface at the root of your server, which Korvex works out from the address you entered. So as long as the WebDAV URL is right, link sharing follows automatically — which is also why an almost-right URL can give you a working connection but broken links. See Unusual setups if your Nextcloud lives in a subfolder.

Step 6 — Test the connection

Already comfortable here? Jump to Step 7.

Do not trust a green checkmark — confirm end to end.

  1. In Korvex, run a backup or add a photo to a job.
  2. Open Nextcloud in a browser and go to Files.
  3. You should see a KORVEX folder at the top level of your account. Open it and find your file.

If the folder appears but the file did not arrive, that is usually storage: check your quota in Personal settings, and check free disk space if you self-host. If nothing appears at all, the error Korvex showed you will point at the cause — see Troubleshooting.

Step 7 — Send your first share link

Pick a job in Korvex, select the photos or videos you want to send, choose the share option, and set an expiry date and password if you want them. Korvex uploads the selected files, turns that folder into a read-only public link, and hands you the URL.

Read-only is deliberate: whoever has the link can view and download but cannot upload, rename or delete anything. Your originals stay untouched.

Test it properly — open the link in a private window, or on your phone with wi-fi off. That is what your client will see. If it loads there but not for them, the problem is on their side.

On passwords and expiry: a password is the difference between “only the client has this” and “anyone the client forwards it to has this”. For anything showing an address, a person’s face or an invoice number, set one. Expiry dates are good hygiene generally — a link from a job you finished two years ago should not still be live. Every link you create is listed in Nextcloud under Files > Shares, and you can revoke any of them there instantly.

The Sync section: upload, restore and disconnect

Below the connection fields, the same Cloud Sync screen has a Sync block with a Last sync timestamp and two buttons.

Control What it does
Upload to cloud Pushes your current Korvex data up to Nextcloud, overwriting what is up there.
Download & restore Pulls the copy from Nextcloud back down, overwriting what is on this device. This is what you use on a new or wiped phone.
Disconnect Forgets the server details on this device. Your files stay on Nextcloud and your jobs stay in the app.

Read the warning on that screen carefully. This is whole-dataset sync on a last-change-wins basis: whichever action you run last is the version that survives. It is not continuous two-way sync like the Nextcloud desktop client. In practice that means two rules — avoid having two devices editing at once, and think about direction before you tap. On a phone holding a day of unsaved site photos, tapping Download & restore replaces them with the older cloud copy.

A good habit: Upload to cloud at the end of a working day, and check the Last sync time before you start on a second device.

What Korvex creates on your server

Everything Korvex writes goes inside a single top-level folder in your own account, so nothing gets scattered:

KORVEX/
  |-- (backups and job files)
  |-- Shares/
        |-- job name/
        |-- job name/

Each job you share gets its own folder under KORVEX/Shares/, and that folder is what becomes the public link. Because it is ordinary Nextcloud storage you can browse it in a browser, open it in the Windows sync folder, back it up, or drag files in and out yourself. Korvex does not hide anything or use a private format.

Two consequences worth knowing: deleting a share folder in Nextcloud kills the link (deleted files go to the Deleted files bin first, so a mistake is recoverable for a while), and the files count against your Nextcloud quota rather than any Korvex limit. Video eats space quickly.

Revoking access

If a phone is lost or stolen, or you are retiring a device: Nextcloud > avatar > Personal settings > Security > Devices & sessions, find the entry you named in Step 3, and click the trash icon.

If you simply want this device to stop syncing but keep everything else intact, Disconnect on the Cloud Sync screen is enough. Revoking the app password in Nextcloud is the stronger step, and the right one for a phone you no longer physically have.

That device can no longer reach your Nextcloud, immediately. Nothing else is affected — your own logins, your other devices and your existing share links all keep working. To reconnect that device later, create a fresh app password and repeat Step 5. Changing your main Nextcloud password does not break app passwords; revoking is the only thing that does.

Troubleshooting

Symptom Cause and fix
Unauthorised / 401 Username or app password is wrong. Usual causes: display name used instead of username, a copy that clipped a character, or a revoked app password. Generate a new one and re-paste both fields.
Not found / 404 The WebDAV URL is wrong. Re-copy it from Files settings rather than typing it, and check the trailing slash and capitalisation.
Uploads work, links fail Sharing is restricted on the server — see Step 4. If password protection is enforced, set a password on the share and try again. On a work Nextcloud an admin may have disabled public links entirely.
Insufficient storage / 507 Your account is out of quota or the server disk is full. Check usage in Personal settings.
Everything times out Confirm you can reach Nextcloud in a browser on the same device and network. If the browser cannot either, the problem is the server or the connection, not Korvex.
Large videos fail partway Usually an upload size limit on a reverse proxy in front of Nextcloud, or a slow connection timing out. Try on wi-fi first to narrow it down.
Connection succeeds, nothing appears Check you are looking at the right account — it is easy to sign in to a personal account in the browser and an admin account in the app.

Unusual setups

Nextcloud in a subfolder. If your address looks like https://yourdomain.com/nextcloud/, your WebDAV URL is https://yourdomain.com/nextcloud/remote.php/dav/files/kev/. Uploads will be fine. Because the sharing interface sits at a different level of the server, subfolder installs are the one layout where links may need extra attention — if uploads work and links do not, leave a comment with your exact address.

Cloudflare in front of your server. Set the DNS record to DNS only (grey cloud), not Proxied (orange). The proxy can block the request types WebDAV uses, which produces confusing partial failures — folders that will not create, uploads that hang.

A reverse proxy (nginx, Apache, SWAG, Caddy). Make sure it passes WebDAV methods through rather than filtering them, and raise the maximum upload size well above your largest video.

Self-signed certificates. Expect connection failures — apps refuse untrusted certificates by design. Nextcloud All-in-One issues a real certificate automatically once your domain resolves, so this is worth fixing rather than working around.

Two-factor authentication. No conflict at all — app passwords bypass 2FA by design, which is exactly why Step 3 exists.

More than one device. Create a separate app password per device with a name you will recognise. Losing one phone then means revoking one line, not resetting everything.

Glossary

Term Plain English
WebDAV The standard protocol apps use to read and write files on a server. It is how Korvex puts photos into your Nextcloud.
App password A long one-off password generated for a single app or device, revocable on its own without changing your real password.
User ID Your internal Nextcloud username, as opposed to the display name other people see. The one that belongs in the URL and the Username field.
Public link A share URL that works without a Nextcloud account. Korvex creates these read-only, optionally with a password and expiry date.
Quota The storage limit on your Nextcloud account. Korvex files count against it.
Two-factor authentication (2FA) A second login step, usually a code from your phone. App passwords work alongside it, which is why apps use them.
Reverse proxy A server that sits in front of Nextcloud and passes traffic to it. Common on self-hosted setups, and a frequent cause of upload size limits.

That is it

Korvex is now writing to storage you own. Your job photos live on your server, your clients get links from your domain, and no third party is holding your files or charging per gigabyte.

Leave a Reply

Your email address will not be published. Required fields are marked *