¶ Connecting your recorder (SFTP, FTP, import from a NAS)
This page walks you through connecting a recorder that sends its footage to WebDisk CVR on its own — over SFTP or over FTP — and through a third option, where you send nothing at all, because the footage is already sitting in your storage and we simply show it to you. If you have UniFi Protect, a different route applies to you; we describe it in Connecting UniFi Protect.
¶ Which route to choose
| Route | When to choose it | Who sends the files |
|---|---|---|
| SFTP | Your recorder has "SFTP" in its menu. This is the default and recommended choice — the transfer is encrypted. | Your recorder |
| FTP | Your recorder cannot do SFTP (typically older devices, and ones that only send JPEG stills). | Your recorder |
| Import from a folder | The footage already reaches your storage — usually put there by a NAS that replicates the archive. | Nobody — the material is already there, we only index it |
💡 If your recorder supports both protocols, choose SFTP. Switching routes later means adding the recorder again from scratch, with a new password.
¶ Before you start
- Make sure your CVR subscription is active — without it the panel still works, but nothing will be archived.
- Connect your storage on the Storage tab. Footage goes into the storage you bought separately in WebDisk Files — see Storage for your footage.
- Check that the clock in your recorder is set correctly. The time reported by the device determines where the recording lands on the timeline.
¶ Step by step: add the recorder in the panel
- Sign in at
cvr.webdisk.ioand go to Panel. - Open the Recorder tab and fill in the form: Recorder name (for example "Warehouse — gate"), optionally Make / model, and in the Protocol list choose
SFTPorFTP. - Click Add recorder. The device is now described, but it is not working yet — it has no site and no storage assigned.
- Go to the Site tab. Create a site (for example "Shop, 3 Kwiatowa St.") and point it at your storage, or open a site you already have.
- Inside the site, pick your recorder from the Recorder at this site list and click Place here.
At that last moment the thing you have been waiting for happens: the recorder is given storage, a folder of its own and an upload account. The panel then shows you a window with the credentials.
⚠️ The recorder only starts working after step 5. For as long as it sits in the unassigned list, no upload account exists.
¶ The details you receive — and the password shown once
After you click Place here, you will see a card titled Settings to enter in your recorder.
| Field in the panel | What it is | Where you use it |
|---|---|---|
| Address | The address your recorder should send files to | The "Server" / "Server address" field in the recorder |
| Protocol | SFTP or FTP — the one you chose |
The protocol selector in the recorder |
| Username | The login of the account created for this one device | The "Username" field |
| Password | 24 characters, randomly generated | The "Password" field |
The panel does not show the port. In your recorder, enter:
- 2022 for SFTP,
- 2121 for FTP.
These are not the default ports (22 and 21), so your recorder will not fill them in by itself — you have to type them in.
🔴 We show the password once and we do not keep it. We store it in no form that could be read back, so neither we nor you can recover it. Before you click I have saved it, enter it in your recorder or save it in a password manager.
¶ You have lost the password — what now
There is no second chance to see the password. The only way forward is to create the account again:
- Inside the site, click Delete next to that recorder. In the confirmation window, do not tick the option to delete footage from storage — the existing material should stay.
- Add the recorder once more (the Recorder tab) and place it at the same site.
- Copy the new credentials into the recorder.
What happens to the existing archive in the meantime: the files stay in your storage, but the new recorder writes to a new folder, so in the panel you will only see material sent from that moment on. The older part of the archive also stops being covered by automatic space reclamation — it sits in storage and takes up the capacity you paid for until you delete it yourself in WebDisk Files. If you need access to it from the panel, write to us using Report a problem in the panel.
¶ Where to enter these details in the recorder
Menu names differ between brands, but the layout is nearly always the same: look for Network → FTP or Storage → FTP, labelled "Upload" or "Auto Backup" by some manufacturers. Inside, fill in:
| Field in the recorder | What to enter |
|---|---|
| Server / Host | The Address from the panel |
| Port | 2022 (SFTP) or 2121 (FTP) |
| Type / Protocol | SFTP or FTP — exactly the one you chose in the panel |
| Username | The Username from the panel |
| Password | The Password from the panel |
| Remote directory / Path | leave it empty, or enter / |
| Passive mode (PASV) — FTP only | on |
| What to send | recordings (and stills, if you want them in the archive) |
Finally, save the settings and use the Test / Check connection button if your recorder has one.
A few things worth knowing before you go looking for a fault where there isn't one:
- Leave the remote directory empty. The account is confined to a folder of its own — once logged in, the recorder sees only its own space and has no access to anything outside it. Entering a path of your own simply creates a subfolder.
- An account works with one protocol only. An account created for FTP will not log in over SFTP, and vice versa. If you pick a different protocol in the recorder than you did in the panel, the login will be rejected even with the correct password.
- The account may only upload. It cannot download or delete anything from your storage. That is deliberate: a password leaking from the recorder does not give access to your archive.
- FTP needs passive mode and outbound connections on ports 50000–50100. The symptom of a badly set passive mode is misleading: the login succeeds, and then the transfer hangs on the first file.
- The camera name comes from the folder layout. If your recorder saves files as
camera/date/file, you will see the camera name in the archive. If it dumps everything into one folder, the Camera column will stay empty — the footage will still be visible and playable. - Recording time. Most recorders give files names of their own that we cannot decode into a recording time — in that case we place the recording on the timeline at the moment the file arrived in storage. With short clips the difference is small, but it is not nil.
¶ Plain FTP — let us be blunt
FTP is not encrypted. Both the account password and the footage itself travel across the network in clear text, and anyone with access to that path can read them. We enable this route deliberately, because some recorders cannot do SFTP and refusing would cut those devices out of the service — but we are not pretending it is safe.
What we do to limit the damage:
- the FTP account has write permission only — it cannot download or delete footage,
- the account is confined to the folder of that one recorder,
- the account will not log in over any other protocol.
What that does not fix: the content of the recordings and the password still travel unencrypted. The decision is yours, at the point where you choose the protocol in the panel — and it is you who judges whether it is acceptable for your data. If your recorder can do SFTP, there is no reason to choose FTP.
💡 Do you have a device that supports FTPS (FTP over TLS) only? That route is not available yet — write to us using Report a problem so that we know it is needed.
¶ Importing from a folder your NAS writes to
Choose this route when the footage already reaches your storage — most often because the recorder dumps it onto a NAS, and the NAS replicates it into your storage in WebDisk Files. You are not reconfiguring a working installation: you point us at a folder, we index it and give you an archive browser.
How to add it:
- On the Recorder tab, choose Material already in storage (NAS) in the Protocol list.
- In the Prefix in the bucket field, enter the folder the footage sits in, for example
monitoring/2026/. This field is required — without it we have nothing to index. - Click Add recorder, then place it at a site with the Place here button.
- Next to the recorder, click Reindex so that you do not have to wait for the next scan.
How this route differs from the others:
| SFTP / FTP | Import from a folder | |
|---|---|---|
| Who puts the files into storage | we do, from what the recorder sends | you do (your NAS) |
| Our rights to that folder | write | read only |
| Do we reclaim space by deleting the oldest footage | yes | no |
| Do we delete files when a recorder is removed | only at your explicit request | never |
⚠️ We never delete imported material — not even when storage fills up. You will still get the same warning email about space running out, but the decision on what to do about it is yours. We describe how space reclamation works in Retention and storage space.
If your NAS changes the folder it keeps footage in, add a new recorder pointing at the new path — we do not move files and we do not change the structure of your folders.
¶ Footage is not appearing in the panel
Start with what takes a second:
- Click "Reindex" next to the recorder, inside the site. We scan the archive automatically every 10 minutes, so a freshly delivered file may simply still be waiting for the next pass. When it finishes you will see the message "Indexed. New recordings: …". If there is a great deal of material — typically on the first import from a NAS — one click may not cover all of it. Click again: we carry on from where we stopped, not from the beginning.
If that did not help, check these in order:
- Is the recorder placed at a site? A device in the unassigned list is only a description of hardware — it has no account and nowhere to write.
- Does the site have storage attached? The site card must name a storage, and that storage must be verified. If it is not, the panel shows an unverified label next to it.
- Has ingest been suspended? When storage fills up and its settings do not let us reclaim space, you will see ingest suspended next to the storage. Enlarge the storage in WebDisk Files and ingest will resume by itself. Details: Retention and storage space.
- Is the recorder sending anything at all? Look at its log or upload status. The most common reasons for rejection are the wrong port (2022 rather than 22, 2121 rather than 21), a different protocol than the one chosen in the panel, and a password copied out with a typo.
- On FTP: login works, the transfer stalls. This is almost always passive mode — turn PASV on in the recorder and allow outbound traffic on ports 50000–50100 through your router.
- Empty files are skipped. A zero-length file is the trace of an interrupted write, so we do not let it into the archive — a recording that cannot be played would be worse than none at all.
- On a NAS import: is the path definitely right? The folder you entered must match, character for character, what you see in WebDisk Files. A typo produces exactly this symptom: an empty archive with no error at all.
Still empty? Write to us with the Report a problem button in the panel, giving the site name, the recorder name and the approximate time the recording should have arrived.
¶ What this service does not do
- It does not replace your recorder. CVR is a second copy kept off site; your recorder still records locally and remains the primary place where footage is stored.
- We do not retry uploads on your recorder's behalf. On the SFTP and FTP routes, the device decides when and what it sends. If it has no retry queue of its own — and most recorders do not — the material from the window when the link was down will never reach the archive. It is worth checking this in your device's menu before you roll the service out.
- We do not transcode footage. MP4 files play straight in the panel; formats the browser does not understand (among them
.dav,.mkv,.aviand.ts) are offered for download.
¶ Documents
The terms on which the service is provided, including the ingest routes and the division of responsibility, are set out in the CVR terms of service. The processing of personal data contained in the footage is governed by the data processing agreement, and your duties as the controller of a CCTV system are summarised in the controller's guide. All three documents are currently available in Polish only.