Basic
Changing, deleting, and creating files through a web-based file manager is easy! We'll show you how to do it, and much more.
Basic File Management
Need to upload worlds, plugins, or edit configuration files? Our web-based file manager makes it simple. This guide covers all essential file operations you can perform directly through your browser.
At the top, you'll find a search bar along with buttons for creating a directory, uploading files, or creating a new file. You'll also see a complete list of your server's files and folders.
Web file editor
After clicking on a file, a web editor with syntax highlighting will open.
If the syntax highlighting does not work or displays incorrectly (this may happen if the file has a non-standard extension), you can force the format using the dropdown list next to the save button.
Uploading files
To upload a file, such as a plugin or a pre-saved world, click the "Upload" button and select the desired file from your computer in the file explorer that opens.
You can also transfer files by dragging and dropping them with your mouse.
The file uploads to your current folder. Note that the upload limit through the web file manager is 512MB. If you need to upload a larger file, use SFTP, we discussed how to use it here.
Context menu
Next to each file or folder, you'll find an additional context menu (three dots) with useful tools, such as:
- Rename: Allows you to change the name of a file or folder.
- Move: Allows you to move a file or folder to another (sub)folder if needed. Use
../to go up one folder and/<folder>to go into a specific folder. - Permissions: A useful and important option that lets you set the permissions for a file or folder. This may be necessary if a plugin or another executable cannot read or create the file or folder. The default value is
755, which is considered secure. Do not change it unless you know what you're doing. - Archive: Creates an archive from one or more selected files or folders. This will create an archive named
archive-yyyy-mm-dd.tar.gzin your current folder. - Unarchive: Extracts the uploaded archive into the current folder.
- Download: Allows you to download the selected file to your computer.
- Delete: Permanently deletes the selected file or folder.
Quick Restore
Quick Restore lets you restore a file or folder to a previous version from your backups. Click the Quick Restore option on any file or folder to see all available versions across your snapshots. You can then choose which version to restore and whether to replace the current file or save it to a different location.
For more details on how versions and snapshots work, see the Backups documentation.
Locked Files
Some files in your application may be locked to prevent accidental modifications. There are two types of locks:
- Fully locked/restricted: These files cannot be accessed or modified through the web file manager. They are protected for security or system stability reasons.
- Soft lock: These files are locked by default but can be unlocked. Click the Unlock button in the top right corner of the file manager to temporarily disable the lock and access these files.
SFTP and other advanced file management methods have access to all files without restrictions, including locked files. Be careful when using these tools as you could accidentally modify or delete critical system files.