Manage server files

The Files tab is a browser-based file manager for your server's data directory — the same files an SFTP client would see. Nothing here requires the server to be stopped; edits, uploads and deletes all work while it's running (the panel just warns you a live server may be writing into a folder you're about to touch).

Browsing

Breadcrumbs at the top track where you are; click a folder to open it, or a breadcrumb segment to jump back up. The search box filters the current folder only — it doesn't search subfolders. Click a column header to sort by name, size, or modified date. Expand switches to a full-window view and adds a folder tree down the left side — folders only, loaded lazily as you open each one — so you can jump straight to a folder anywhere in the data directory instead of stepping through breadcrumbs one level at a time; the list takes the rest of the row, and the editor gets its own column once a file is open.

Creating and editing files

New File creates an empty file and opens it directly in the built-in editor below the list; New Folder creates an empty folder. Both ask for a name through a dialog — that name can't contain /, \, line breaks, or tabs, so a pasted multi-line block can't accidentally turn into a directory tree.

Click any file to open it in the editor, make your changes, and click Save. A very large file opens read-only, marked "(too large to edit)". Use a row's ⋯ menu for Rename or Copy (same name dialog, same restriction).

Uploading and downloading

Use the Upload button or drag files onto the list. Uploading a name that already exists in the folder asks you to confirm the overwrite first. Uploads are capped at 512 MB per file, but the browser itself doesn't check that before sending — a larger file starts uploading and the control plane cuts it off once it hits the cap, so there's no benefit to trying anyway; keep files under the limit to begin with.

A file's ⋯ menu also has Download, which streams it straight from the server.

Deleting

Delete works two ways: a single row's ⋯ menu, or a bulk selection made with checkboxes (including across a filtered view). Deleting a folder first measures what's inside and shows the count and size in the confirmation — or says plainly that it couldn't measure it, if the walk failed or was too large to finish.

Typed confirmation replaces the plain click-through whenever any of these apply, since these are the cases whose loss can end the server rather than just remove a file:

• more than 1,000 files — that folder's own count for a single-row delete, or the combined count across the whole selection for a bulk delete, so several folders each under the threshold can still trip it together
• it (or, in a bulk selection, any part of it) couldn't be fully measured
• it's a protected folder: world, world_nether, world_the_end, plugins, mods, config, configs, or your active world's own folder name and its _nether/_the_end companions if it isn't named world

What you're asked to type depends on which path triggered it. Deleting a folder from its own ⋯ menu always asks for that folder's exact name when the gate fires, regardless of what else is checked elsewhere in the list. Deleting via a bulk (checkbox) selection asks for the name only when that one folder is the entire selection; any other selection that trips the gate — several folders together, or a protected folder checked alongside even a single file — asks for the literal word "delete" instead. None of this is reversible.

SFTP access

For anything bigger than the browser is built for — bulk transfers, files over the 512 MB upload cap, or a workflow you already run through a desktop client — enable SFTP under Settings → SFTP access. Turning it on gives you a host, port, username, and password; the password is shown once, so save it immediately. Rotate password issues a new one and invalidates the old one instantly; disabling SFTP does the same. Use any standard SFTP client (FileZilla, WinSCP) to connect.

Troubleshooting

Upload rejected for size. Anything over 512 MB gets rejected by the control plane partway through the upload — there's no browser-side warning beforehand. For anything larger, use SFTP instead.

Can't create a file or folder with the name I want. Names can't contain /, \, line breaks, or tabs — that guard exists specifically because a name field is not a place to paste multi-line content.

Delete asks me to type something before it'll proceed. That's expected for a large, unmeasured, or protected folder (the world and its _nether/_the_end companions, or a plugins/mods/config/configs folder). From a row's own ⋯ menu it always asks for that folder's exact name. From a bulk (checkbox) selection it asks for the name only when that folder is the entire selection — anything else alongside it, another folder or even just one file, gets the literal word "delete" instead. Either way, it's the deliberate extra step before an unrecoverable delete.

Lost the SFTP password. It can't be recovered — it's shown once, at creation or rotation. Click Rotate password to get a new one.