File manager and SFTP problems

This page covers the Files page in the panel and connecting with an SFTP program such as FileZilla or WinSCP. See Files for the basics.

Upload fails or stalls

Why it happens: Large files, unstable connections, or a full disk can make uploads fail.

How to fix it:

1. Check that you have free disk space. See Disk full.
2. Try a smaller file to see if uploads work at all.
3. Zip many small files into one archive, upload it, then Unarchive it in the panel.
4. For big files, use SFTP instead (see below).

File is too large to upload

Why it happens: The browser upload has a size limit. The usual limit is 100 MB per upload.

How to fix it:

1. Use SFTP for anything larger.
2. Alternatively, use Pull from URL on the Files page if the file is available at a download link.

File is too big to edit in the browser

Why it happens: The editor only opens files up to a small size limit (about 4 MiB in a standard setup).

How to fix it:

1. Download the file, edit it on your PC, and upload it again.
2. Or use SFTP and edit it with a text editor.

Cannot save a file

Why it happens: Usually you lack the file update permission, the disk is full, or the file is locked or read-only.

How to fix it:

1. If you are a subuser, ask the owner to give you the file update permission (see Users).
2. Check that the disk is not full.
3. Check the file’s Permissions from its menu.
4. Some games rewrite their config on shutdown and overwrite your edit. Stop the server, then edit, then start it.

Permission denied

Why it happens: Either your subuser account lacks a file permission, or the file on disk has permissions that block the change.

How to fix it:

1. As a subuser, ask the owner to check your file permissions (create, read, update, delete, archive, sftp).
2. Try the file’s Permissions option and make sure the owner can read and write.
3. If it persists on a file the game created, open a ticket.

“This server is currently running its installation process and most actions are unavailable.”

Why it happens: The server is still installing or reinstalling. Files actions are blocked until it finishes.

How to fix it:

1. Wait a few minutes and refresh.
2. If it never finishes, see Startup, version and software-switch problems.

“This server is currently suspended and the functionality requested is unavailable.”

Why it happens: The server is suspended, for example for an unpaid invoice.

How to fix it:

1. Check your invoices in the client area. See Renewals.
2. If you think it is a mistake, open a ticket.

The file manager is empty or will not load

Why it happens: A network hiccup, a browser extension, or the server node being briefly unavailable. An empty list may also be a real empty folder.

How to fix it:

1. Refresh the page, then try another browser or a private window.
2. Turn off ad blockers and privacy extensions for the panel.
3. Check whether the server itself shows in the Console. If not, see Panel errors.
4. If it keeps failing, open a ticket.

A folder shows “too large to display” or looks incomplete

Why it happens: The panel cuts off very large folders in the listing.

How to fix it:

1. Use SFTP to browse the whole folder.
2. Clean out old files (logs, crash reports) to shrink the folder.

Cannot delete or rename a file while the server is running

Why it happens: The game may hold the file open, or recreate it right away.

How to fix it:

1. Stop the server and try again.
2. Make sure you have the file delete permission if you are a subuser.

Archive or Unarchive fails

Why it happens: The archive may be corrupted, in an unsupported format, or the disk may be too full to unpack it.

How to fix it:

1. Check free disk space, since unpacking needs room.
2. Re-download and re-upload the archive in case it was damaged.
3. Try a common format such as .zip or .tar.gz.
4. If you are a subuser, you need the archive permission.

SFTP: connection refused or timed out

Why it happens: Wrong host or port, or a firewall on your network blocking the SFTP port.

How to fix it:

1. Open Settings > SFTP Access in the panel and copy the address and port shown there.
2. The port is normally 2022.
3. Use a different network (for example a phone hotspot) to test for a firewall block.
4. If the details are right and it still fails, open a ticket.

SFTP: wrong port

Why it happens: Programs often default to port 22, which is not the game server SFTP port.

How to fix it:

1. Set the port to the one shown under Settings > SFTP Access (normally 2022).

SFTP: wrong username format

Why it happens: The username is not just your account name. It combines your panel username and the server’s short ID.

How to fix it:

1. Copy the username exactly from Settings > SFTP Access. It looks like youraccount.serverid.
2. Do not type the email address.

SFTP: authentication failed

Why it happens: Wrong password, wrong username, or missing permission.

How to fix it:

1. The password is your panel account password. Check it by logging in at panel.omnehosting.com.
2. Your client area password and your panel password may be different logins. See Panel login and account problems.
3. SFTP password login does not ask for a two-factor code.
4. If you are a subuser, the owner must give you the file and SFTP permissions.
5. Repeated failed logins are slowed down, so wait a few minutes before trying again.

Host key warning on first connect

Why it happens: Your SFTP program has never seen this server before, so it asks you to trust its key.

How to fix it:

1. Accept the key the first time.
2. If it later warns that the key changed unexpectedly, be careful. It can happen after a server move or rebuild. If you did not expect it, open a ticket before continuing.

SSH key login does not work

Why it happens: The key was not added to your panel account, or the program is offering a different key.

How to fix it:

1. In the panel’s Account area, add your public key under SSH Keys. Only paste the public key.
2. In your SFTP program, point it at the matching private key.
3. Make sure the key type is supported by your program.
4. If it fails, use your panel password to confirm the rest of the setup works.

FileZilla or WinSCP settings

Why it happens: Choosing the wrong protocol is a very common cause of failure.

How to fix it:

1. Choose SFTP (SSH File Transfer Protocol), not FTP or FTPS.
2. In FileZilla, enter sftp://address as the host, or choose SFTP in the site manager.
3. In WinSCP, set File protocol to SFTP.
4. Enter the port, username, and password from Settings > SFTP Access.

Slow transfers

Why it happens: Thousands of small files transfer much slower than one big file. Your own connection speed also matters.

How to fix it:

1. Zip the folder, transfer the one archive, and unpack it in the panel.
2. Lower the number of simultaneous transfers in your SFTP program if it is failing.

Folder shows as empty over SFTP

Why it happens: You may be looking at the wrong path, or your account lacks the read permission.

How to fix it:

1. Go to the root folder (/) after you connect.
2. Compare with what you see in the panel Files page.
3. If you are a subuser, ask the owner about your file permissions.

Filenames with special characters break

Why it happens: Spaces and unusual characters can confuse configs and tools.

How to fix it:

1. Use simple names: letters, numbers, dashes, and underscores.
2. Rename the file in the panel.

Paths are case sensitive

Why it happens: Game servers run on Linux, where Plugins and plugins are different names.

How to fix it:

1. Match capitalization exactly, in both file names and config entries.
2. If a game cannot find a file you uploaded, check the case first.

Files have the wrong permissions after upload

Why it happens: Some uploaded files, especially scripts, may not be readable or runnable by the game.

How to fix it:

1. Use the file’s Permissions option in the panel to set read and write for the owner.
2. If the game still cannot use the file, open a ticket.

Still stuck?

Open a ticket or ask on Discord. See Contact support. Tell us what you were doing, and any exact error text.