Documentation

Unable to download the file

To publish a page, Surreal CMS downloads the page's file from your server, updates its content regions, and uploads it again. This message means the download failed:

Unable to download the file from your server. The file may have been moved or deleted since the list was loaded.

Nothing on your server has changed, and your changes are still in the editor.


Common causes

  • The file was moved, renamed, or deleted. Surreal CMS looks for each page at the path it was enabled with. If someone changed the file with another app, Surreal CMS can't find it.
  • The home folder changed. Page paths start at the site's home folder. If the home folder in Edit Site no longer points to the same folder as the site's URL, every path is wrong.
  • The user can't read the file. The user you connect with needs permission to read your website's files.
  • Passive FTP is blocked. FTP transfers files over passive connections. Ask your host to confirm that passive FTP is turned on and that its port range is open in the firewall.

How to fix it

  1. Connect to your server with another app and look for the page's file. The path Surreal CMS uses is shown under the page's name in the site's list of pages.
  2. If the file moved on purpose, Disable the page in Surreal CMS, then use Enable Pages to add it again from its new location. If it moved by mistake, move it back.
  3. If the file is where it should be, check the home folder and the file's permissions, then publish again.

If you're still stuck, contact us and tell us which site and page you're publishing.