Remote File Manager

Browse the drives of a managed Windows device from the portal, and upload, download, rename and delete files there, without opening its screen or a shell.

WindowsAccount Owners and Admins can use it, and MSP Technicians can when the Account Owner allows them to open remote shells; Read Only and MSP Read Only users cannot

In short

  • It is off until an Account Owner or tenant Admin turns on Allow the remote file manager in Settings.
  • It runs as the system account: it works with nobody signed in, shows nothing on the device, and does not see a user's mapped network drives.
  • Every upload, download, rename, delete and new folder is written to the Audit Log. Browsing is not.
  • It is as powerful as Remote Shell: someone who can replace files as the system account can also run programs on the device.
  • Deleting is permanent. Nothing goes to the Recycle Bin.
  • A session ends after 15 minutes without activity, and after two hours in any case.

Requirements and access

Access
An Account Owner or tenant Admin turns on Allow the remote file manager in Settings and clicks Save Changes. MSP Technicians can use it only when the Account Owner has also switched on Allow MSP Technicians to use remote shell and the file manager: one switch covers both features, because both act as the system account on the device.
Device
A Windows device that is online, with an agent new enough to support the file manager. Agents update themselves; a device that is not ready yet says so on its Files page. macOS is not supported.
Network
Files travel over a direct, encrypted WebRTC connection between your browser and the device, the same way Remote Shell does, so the same STUN and TURN servers apply. When no direct path exists the connection goes through the relay, the status line shows "Via relay", and transfers are slower.

Open the file manager

  1. Open a Windows device and choose Files.

    The file manager opens in its own tab.
  2. Select Connect.

    A device runs one remote session at a time. If a remote desktop, shell or file session is already active, review who started it before choosing Take over, which ends that session.
  3. Pick a drive under This device and open folders by clicking their names.

    The path bar shows where you are; click any part of it to go back up. To jump straight to a folder, click the pencil at the end of the path bar and type the path, for example C:\ProgramData\Pckgr\Logs.

Click a column heading to sort by name, size or modified date. Hidden and system items are listed too, dimmed and marked "hidden". Select End session when you are done; closing the tab ends it as well.

It sees the device as the system account does

Only the device's own drives are available. Network paths and a signed-in user's mapped drives are not, and a few folders that Windows protects even from the system account cannot be opened.

Upload files to the device

  1. Open the folder the files should go into.

  2. Drag the files onto the list, or choose Upload and pick them.

    Several files can be added at once. They upload one at a time, in order, and appear under Transfers with their progress.
  3. If a file with the same name is already there, choose Replace or Skip.

    Skipping leaves the existing file alone and still uploads the others.

A file takes its place in the folder only when the whole upload has arrived. An upload that is cancelled or cut off leaves nothing behind, and a file it was replacing stays as it was.

Note

Folders cannot be uploaded. Upload the files inside them, or a zip of the folder.

Download a file from the device

  1. Find the file and select the download button at the end of its row.

  2. In Chrome or Edge, choose where to save it.

    The file is written straight to that location as it arrives, so its size is limited only by your disk.

Other browsers cannot write a download straight to disk. There the file is held in the browser until it is complete and then saved to your downloads folder, and files over 1 GB are refused: use Chrome or Edge for those.

A file that another program has open for writing, such as a log, can still be downloaded. Folders cannot be downloaded in one go.

Rename, delete and create folders

New folder
Creates a folder in the folder you are viewing.
Rename
The pencil on a row renames the file or folder in place. It does not move it to another folder.
Delete
The bin on a row deletes the file, or the folder with everything inside it, after you confirm. A link to another location is removed as a link; what it points to is left alone.

Deleting is permanent

Deleted files and folders do not go to the device's Recycle Bin and cannot be restored from Pckgr.

What the file manager will not change

The file manager can do nearly everything the system account can, so a few things are refused outright to prevent a mistake that would break Windows or cut the device off from Pckgr.

RefusedStill allowed
Deleting or renaming a driveEverything on the drive
Deleting or renaming the Windows, Program Files, Program Files (x86), ProgramData and Users folders themselvesFiles and folders inside them
Changing the Pckgr agent’s own program files, or the folder that holds themReading them, including the agent’s logs
Downloading or changing the file that holds the device’s Pckgr identityEverything else in the Pckgr data folder

These rules apply to where a path really leads. A link or junction with a different name, such as the built-in C:\Users\All Users, does not get around them, and a link that leads to a network location is not opened.

Windows has its own protections on top of these. When Windows refuses something, or a file is in use by another program, the file manager says so and nothing is changed.

This is not a restricted mode

The protected list prevents accidents; it does not make the file manager a safer alternative to Remote Shell. Anyone allowed to use it can replace programs and settings on the device, so allow it only for people you would also trust with a shell.

Transfers and limits

Transfers run one at a time and wait their turn under Transfers. You can keep browsing while one runs, and cancel a waiting or running transfer with the cross on its row. A running transfer shows its speed and the time it has left. A transfer that failed or was cancelled has a Try again button on its row; an upload that failed because the name was already taken offers Replace instead.

Idle time15 minutes
A session with no browsing, changes or transfer progress for 15 minutes ends. The page warns you three minutes before.
Session length2 hours
An absolute limit on every session. A transfer still running when it is reached is cancelled. The page warns you ten minutes before.
Sessions per deviceOne
Remote desktop, remote shell and the file manager share the device’s single session.
Folder listing20,000 items
A folder with more shows the first 20,000 and says so. Type the path of the subfolder you need to go straight to it.
Recorded actions5,000 per session
A session that reaches this many audited actions ends. Connect again to continue.
Pending connection90 seconds
A connection that hasn’t opened by then expires.

Leaving the page stops transfers

Closing the tab, ending the session or losing the connection cancels a transfer in progress. The browser asks before you leave while transfers are running, and so does End session. After a session ends, the list of transfers stays on the page so you can see which files finished.

What is recorded

The device reports each upload, download, rename, delete and new folder to Pckgr before carrying it out, and does it only once Pckgr has recorded it. If the device cannot reach Pckgr to record an action, the action is refused and the session ends.

  • Each entry in the Audit Log names the admin, the device and the path. The path is the real location, after following any links. A very long path keeps its beginning and its end.
  • An upload that replaced an existing file, and a folder deleted with its contents, are marked as such.
  • A transfer gets a second entry when it finishes, with its size, its SHA-256 and whether it completed, failed or was cancelled.
  • The details of these entries are what the device's agent reported, and each entry is marked as reported by the device.
  • Opening and ending a session are recorded, as is changing the setting.
  • Browsing folders is not recorded.
  • File contents go from your browser to the device or back and are not stored by Pckgr.

The same entries appear on the device's Activity tab.

Troubleshooting

MessageWhat it means
“The file manager is turned off for this tenant”An Owner or Admin has not turned it on in Settings.
“This device’s agent needs updating”The device’s agent does not support the file manager yet. It updates itself; try again after its next check-in.
“Could not establish a connection to the device”No WebRTC path opened within 45 seconds, not even through the relay. Check that the device and your browser can reach the STUN and TURN servers listed under Hardened Environments.
“Windows denied access, even to the SYSTEM account”Windows protects that file or folder from every account.
“The file is in use by another program”Something on the device has it open in a way that blocks the change. Close that program or try later.

For firewall and endpoint-security requirements, see Hardened Environments.