Skip to main content

​
Overview

The built-in file manager provides complete access to your game server files through a modern web interface. Edit configuration files, upload mods, manage worlds, and organize directories—all without leaving your browser.

Web-Based Editing

Edit text files directly in the browser with syntax highlighting

Drag & Drop Upload

Drag files from your desktop to upload instantly

SFTP Access

Connect with FileZilla, WinSCP, or command-line SFTP

Archive Support

Create and extract compressed archives (.tar.gz, .zip)

​
File Manager Interface

The file manager displays your server’s /home/container directory: Breadcrumb Navigation: 
/ home → plugins → WorldEdit
Click any segment to jump to that directory. Folder View: Visual folder cards show:
  • Folder name
  • Folder icon
  • Click to navigate inside
File Table: Lists all files with:
  • Name: File or folder name with icon
  • Size: File size (folders show ”—”)
  • Modified: Last modification timestamp
  • Actions: Rename, delete, download, edit

​
Storage Usage

Top bar shows disk consumption: 
2.47 GB / 10.0 GB
[████████████░░░░░░░░] 24.7%
Color Coding:
  • 🟢 Green: Less than 70% used
  • 🟡 Yellow: 70-90% used
  • 🔴 Red: Greater than 90% used

​
Toolbar Actions

Navigate to parent directoryShortcut: Click breadcrumb segment

​
File Operations

​
Creating Files

1

Click New File

Toolbar → New File
2

Enter Name

Type filename: server.properties
3

Create

File is created with empty content
4

Edit (Optional)

If editable extension, redirected to editor
Editable Extensions:
  • .yml, .yaml - YAML configuration
  • .json - JSON data
  • .txt - Text files
  • .properties - Java properties
  • .conf, .cfg, .ini - Config files
  • .log - Log files
  • .md - Markdown
  • .sh, .bat - Shell scripts
  • .toml - TOML configuration

​
Creating Folders

  1. Click New Folder
  2. Enter name: plugins
  3. Folder appears in list
  4. Click to navigate inside
Permission: files.create

​
Uploading Files

​
Method 1: Upload Button

  1. Click Upload in toolbar
  2. Click Select Files or drag files into modal
  3. Select one or more files
  4. Click Upload
  5. Progress shown in upload indicator

​
Method 2: Drag & Drop

Drag files from desktop directly onto the file manager:
  1. Open file explorer on your computer
  2. Drag files over the file manager
  3. Drop anywhere (except modals)
  4. Files upload automatically
Upload Handling:
  • Text files (less than 1 MB): Read as text and uploaded via API
  • Binary files (images, archives, executables): Multipart upload
  • Multiple files: Uploaded sequentially with progress tracking
Permissions:
  • files.write - Required for text file upload
  • files.create - Required for binary file upload
Upload limits are configured per node (default: 100 MB). Larger files must be uploaded via SFTP.

​
Editing Files

Edit supported file types in the browser:
  1. Click on a file name (if editable) OR
  2. Click Actions → Edit
  3. Opens dedicated editor page
  4. Edit content with syntax highlighting
  5. Click Save to persist changes
Editor Features:
  • Syntax highlighting for common formats
  • Line numbers
  • Auto-indent
  • Find/replace
  • Keyboard shortcuts (Ctrl+S to save)
Permission: files.write
Files on the deny list (configured in blueprint) cannot be edited. This protects critical game files like server.jar.

​
Downloading Files

  1. Click Actions → Download
  2. System generates temporary signed download URL
  3. Browser opens download in new tab
  4. URL expires after 5 minutes
Permission: files.read

​
Renaming Files

  1. Click Actions → Rename
  2. Enter new name
  3. Click Rename
  4. File is renamed in place
Permission: files.write
Renaming critical files (e.g., server.jar → old.jar) may break your server. Proceed with caution.

​
Deleting Files

​
Single File

  1. Click Actions → Delete
  2. Confirm deletion
  3. File is permanently removed

​
Multiple Files

  1. Check boxes next to files to delete
  2. Click Delete in toolbar
  3. Confirm bulk deletion
  4. All selected files removed
Permission: files.delete
File deletion is permanent. There is no recycle bin. Create a backup before deleting important files.

​
File Permissions (chmod)

Change Unix file permissions:
  1. Click Actions → Permissions
  2. Set read/write/execute for:
    • Owner
    • Group
    • Others
  3. Click Update
  4. Permissions applied (e.g., 644, 755)
Permission: files.write Common Modes:
  • 644 - Files (owner read/write, others read)
  • 755 - Folders and executables (owner read/write/execute, others read/execute)
  • 600 - Private files (owner only)

​
Archiving Files

Create compressed archives:
  1. Select files to archive (checkboxes)
  2. Click Archive (future feature)
  3. Choose format (.tar.gz, .zip)
  4. Archive is created
Extraction:
  1. Upload archive file
  2. Click Actions → Extract
  3. Files extracted to current directory
Permission: files.archive
Archive features are planned but not yet implemented in current version.

​
SFTP Access

Connect to your server files via SFTP for advanced file management:

​
Connection Details

Navigate to Server → Network to view SFTP credentials:
FieldValue
HostNode hostname (e.g., node1.example.com)
PortSFTP port (default: 2022)
Username{server_id}.{your_email}
PasswordYour panel account password
Example: 
Host: node1.stellarstack.app
Port: 2022
Username: [email protected]
Password: your_panel_password
Permission: files.sftp

​
Using FileZilla

1

Open FileZilla

Download from filezilla-project.org
2

Enter Connection Details

  • Protocol: SFTP
  • Host: node1.stellarstack.app
  • Port: 2022
  • Username: {server_id}.{email}
  • Password: Your panel password
3

Connect

Click Quickconnect or save as a site
4

Navigate

You’ll be automatically placed in /home/container

​
Command-Line SFTP

sftp -P 2022 [email protected]@node1.stellarstack.app
Common commands: 
ls                     # List files
cd plugins             # Change directory
get server.properties  # Download file
put config.yml         # Upload file
mkdir backups          # Create directory
rm old.log             # Delete file

​
WinSCP (Windows)

  1. Download WinSCP
  2. Create new session:
    • File protocol: SFTP
    • Host name: node1.stellarstack.app
    • Port: 2022
    • Username: {server_id}.{email}
    • Password: Your panel password
  3. Click Login
  4. Browse and manage files

​
Permissions

File management requires these permission nodes:
PermissionDescription
files.readView and download files
files.writeEdit existing files
files.createCreate new files and folders
files.deleteDelete files and folders
files.archiveCreate and extract archives
files.sftpConnect via SFTP

​
Permission Examples

Read-Only Access: 
["files.read"]
User can browse and download files but cannot modify. Editor Access: 
["files.read", "files.write"]
User can view and edit files but not create or delete. Full File Access: 
["files.*"]
Wildcard grants all file permissions including SFTP.

​
File Polling

The file manager auto-refreshes every 3 seconds to detect:
  • Files uploaded via SFTP
  • Changes made by game server (new logs, worlds)
  • Modifications from other users
This keeps the view synchronized with the actual filesystem.

​
Hidden Files

Files starting with . are hidden by default:
  • .gitignore
  • .env
  • .minecraft
Click Show Hidden to reveal these files. Toggle State: Saved to browser localStorage per user.

​
Blueprint File Denylist

Blueprints can restrict file access: 
{
  "fileDenylist": [
    "server.jar",
    ".git/*",
    "*.exe"
  ]
}
Denylisted files:
  • Cannot be deleted
  • Cannot be renamed
  • Cannot be edited
  • Can still be downloaded (read-only)
This protects critical game binaries and system files.

​
Best Practices

Before editing configuration files:
  1. Create a server backup
  2. Or download the file locally first
  3. Edit in file manager
  4. Test changes
  5. Restore if needed
For files greater than 100 MB:
  • Web upload may time out
  • Use SFTP client for reliable transfer
  • Supports resume on disconnection
Keep files organized:
  • plugins/ - Plugin JAR files
  • configs/ - Configuration files
  • backups/ - Manual local backups
  • worlds/ - Game worlds/maps
Watch the disk usage bar:
  • Delete old logs regularly
  • Remove unused plugins/mods
  • Clean up old world backups
  • Request disk increase if needed
Name files clearly:
  • ✅ server.properties.backup-2026-03-01
  • ✅ config-working.yml
  • ❌ config2.yml
  • ❌ test.txt

​
Troubleshooting

​
Cannot Edit File

Symptoms: Edit button is grayed out or missing Causes:
  1. File extension not editable (only .yml, .json, etc. supported)
  2. File on blueprint denylist
  3. Missing files.write permission
  4. File is a binary format
Solution: Download file and edit locally, then re-upload.

​
Upload Fails

Symptoms: Upload stuck or shows error Causes:
  1. File too large: Exceeds node upload limit (default 100 MB)
  2. Disk full: Server reached disk quota
  3. Permission denied: Missing files.create or files.write
  4. Network timeout: Poor connection
Solutions:
  • Use SFTP for large files
  • Delete old files to free space
  • Check permissions
  • Retry upload

​
SFTP Connection Refused

Symptoms: Cannot connect via SFTP client Causes:
  1. Wrong port: SFTP port is not 22 (usually 2022)
  2. Wrong username format: Must be {server_id}.{email}
  3. Wrong password: Use panel account password, not server password
  4. Missing permission: Lack files.sftp permission
  5. Node offline: Daemon is not running
  6. Firewall: SFTP port is blocked
Solutions:
  • Verify connection details from Network page
  • Use format: [email protected]
  • Confirm node is online
  • Check firewall allows port 2022

​
Files Not Showing

Symptoms: Uploaded files don’t appear in file manager Causes:
  1. Hidden files: Files start with . and hidden files are off
  2. Wrong directory: Uploaded to different folder
  3. Polling delay: Wait 3 seconds for auto-refresh
Solutions:
  • Enable “Show Hidden Files”
  • Navigate to correct directory
  • Manually refresh page

Build docs developers (and LLMs) love

Get started for freeTalk to us