Files

Browsing, searching, and sorting#

The Files tab shows everything in your server directory. Click a folder to open it, and use the breadcrumb path along the top to step back up. The first crumb is always labelled root, and each folder you open adds another link you can click to jump straight back to that level.

The search box filters the folder you are currently in. It does not search the whole tree, so open the folder you want before you start typing. When a folder has nothing in it, the panel shows This folder is empty. instead of a blank list.

Large folders load in pages. As you scroll, the panel pulls in more rows and shows a running count such as Loading more files..., and once everything is loaded it shows the total file count at the bottom of the list. If you search before the whole folder has loaded, the panel tells you how many of the loaded files match and prompts you to clear the search to load more.

The "Sort by" button above the file list orders the current folder by Name, Size, or Date. Pick an option to sort by it, and click the same option again to flip between ascending and descending. Folders always group ahead of files regardless of the order you choose.

The refresh button next to it (the circular arrow) reloads the folder from the server, which is handy after a change made over SFTP or by the server itself.

Creating files and folders#

The "New File" and "New Folder" buttons sit at the top of the Files tab. Use "New File" to create an empty file, or "New Folder" to create a directory. Both new items land in the folder you are looking at right now.

When you create a folder, the dialog shows you exactly where it will end up, written out as a /root/ path that updates as you type the name. Type the name, check the preview, and confirm with "Create".

Uploading#

The "Upload" button sends files from your computer into the folder you have open. You can pick more than one file at a time. You can also drag files from your desktop onto the page, and a drop zone appears that reads "Upload to" followed by your server name.

Whether you can upload a whole folder depends on the server type. On servers that support it, an extra "Upload Folder" button appears next to "Upload" and folder drag-and-drop works. On other server types, folder uploads are rejected with a message that they are not supported, so connect over SFTP for those. Empty files and empty folders cannot be uploaded either way.

Editing files#

Click a text file to open it in the built-in editor. The editor picks a language for syntax highlighting on its own, and you can override that with the language dropdown at the bottom if it guesses wrong. Press Ctrl+Fto open Find & Replace within the file.

When you are done, the "Save" button writes your changes and leaves the server running. You can also press Ctrl+Sto save without reaching for the mouse, and the editor shows a "Saved" indicator with how long ago the last save happened. Next to Save there is a small dropdown with a second option, "Save & Restart", which writes your changes and restarts the server so they take effect right away.

Reach for "Save & Restart" when you have edited a config file the server only reads at startup, such as the server settings files that load on boot. If you save a YAML file that has parse errors, the editor warns you and asks whether to save anyway, since a broken config can stop the server from booting. Binary files and archives will not open in the editor, so download those to your computer instead.

Structured editors for properties and NBT#

A couple of file types open in a purpose-built editor instead of plain text. When you click server.properties, the panel shows a form with one labelled row per setting, a search box at the top to jump to a setting by name, and a description for each option so you do not have to remember what every key does. If you would rather edit the raw text, there is a switch to drop down to a plain CodeMirror view, and the panel reseeds the form when you switch back. A very large or unparseable file opens straight in the raw editor with a note explaining why.

Minecraft NBT containers such as level.dat and player.dat open in a tree editor where you can expand tags and change their values in place, which beats trying to read the binary format by hand. This covers the common NBT extensions like .dat, .nbt, .schem, and .litematic. Region files (.mca and .mcr) use a different chunk-indexed format and do not open in the NBT editor.

Right-click and mass actions#

Right-click any file or folder to bring up its menu. The exact options depend on what you clicked, since some only apply to files:

• Rename changes the name in place.
• Move opens the "Moving files/folders" dialog with the current name in the "File Name" field and a "New location" preview written as a /root/ path. Edit the path to point somewhere else and confirm with "Move".
• Permissions (Advanced) opens the "Configure permissions" dialog where you set the file mode.
• Duplicate makes a copy in the same folder with copy added before the extension, so server.properties becomes server copy.properties. This one is for files only.
• Archive packs the item into a single .tar.gz archive. If you right-click something that is already an archive, this option becomes Unarchive, which unpacks it in place.
• Download saves the file to your computer. Folders do not have this option, so archive a folder first if you want to pull it down through the panel.
• Delete moves the item to the Trash after a confirmation.

To act on several items at once, tick the checkboxes next to them, or use the checkbox by the breadcrumb bar to select everything in the folder. A bar slides up from the bottom of the screen with the actions that work in bulk: "Move", "Archive", and "Delete". The other menu options, like Rename and Permissions, run on one item at a time from the right-click menu.

Trash#

Deleting a file does not wipe it right away. It goes to the Trash, where it is kept for a limited time so you can put it back if you delete something by mistake. Open the Trash from the "Trash" button at the top of the Files tab, which shows a badge with the number of entries waiting in it. The Trash page lists how many entries it holds and how much of its size cap they take up.

Entries group by deletion session by default, so everything you removed in one go stays together. Untick "Group by deletion session" to see a flat list instead. Tick the entries you want, then use the bar at the bottom:

• Restore selected puts the entries back in their original location. If something already exists at that path, a "Restore conflicts" dialog appears and offers to restore the conflicting entries with a (restored) suffix instead of overwriting.
• Empty selected permanently deletes the chosen entries. This cannot be undone, so the dialog makes you type delete to confirm.

To clear everything at once, use the "Empty trash" control at the top of the Trash page. Emptying the Trash frees the space immediately rather than waiting for entries to age out.

SFTP access#

SFTP is the way to transfer files in bulk, and the most reliable way to move a whole folder on server types where the panel cannot upload one. The connection details live on your server's Settings tab under "SFTP Details", and they look like this:

Address:  sftp://<ip>:<port>
Username: username.serverid
Password: the same password you use to sign in to the panel

For client setup and a step-by-step walkthrough, see connecting over SFTP. If your account shares a login with other people, check users and permissions for which account to use.

Things to watch for#

The .pyroignore file controls what your backups leave out. Edit it like any other text file, and the editor shows a banner reminding you what it does. Each line is a path to skip, wildcards work with an asterisk (*), and you can cancel out an earlier rule by starting a line with an exclamation mark (!).