Create a backup: back up files via SSH
Before updates, migrations or major changes, create a manual backup of your web files as a compressed archive. Via SSH, this works reliably for data of any size.
Prerequisites
Section titled “Prerequisites”- SSH access that is set up.
- Enough free disk space for the archive (roughly half the project size, usually less thanks to compression).
Step by step
Section titled “Step by step”-
Connect via SSH and change to your website’s directory:
Terminal window cd ~/httpdocsTerminal window cd ~/public_html -
Create the archive one level above the web directory, with the date in its name:
Terminal window tar cvzf ../backup-2026-06-11.tgz * .htaccessThe explicit
.htaccessat the end is important:*does not match hidden files (anything starting with a dot). -
Wait until the command prompt returns. Depending on the project size, this takes a few minutes.
-
Check the result:
Terminal window ls -lh ../backup-2026-06-11.tgztar tzf ../backup-2026-06-11.tgz | tail -n 3A plausible size plus an error-free listing of the last entries means the archive is complete.
Troubleshooting
Section titled “Troubleshooting”tar: Cannot open: No space left on device
Section titled “tar: Cannot open: No space left on device”The account does not have enough free space for the archive.
Solution: Delete old backups and files you no longer need, or stream the archive directly to your computer: ssh -i ~/.ssh/YOUR-KEY USER@yourdomain.com "cd ~/httpdocs && tar czf - * .htaccess" > backup-lokal.tgz (adjust the path for your panel).
Hidden files are missing from the archive
Section titled “Hidden files are missing from the archive”* does not match files starting with a dot. Besides .htaccess, this affects files such as .env or .user.ini.
Solution: Add hidden files explicitly (tar cvzf ../backup.tgz * .htaccess .env), or back up the entire directory from outside: cd ~ && tar cvzf backup.tgz httpdocs/ (includes everything, dot files too).
tar: file changed as we read it
Section titled “tar: file changed as we read it”A process changed files while the archive was being created. This is typical for live shops (cache, logs, sessions).
Solution: This is usually harmless if only cache or log files are affected. For a consistent state, enable the application’s maintenance mode and create the archive again.
Related articles
Section titled “Related articles”- Back up a MySQL database (export): the second half of a complete backup.
- How often is my data backed up?: what the server backups cover in addition.
- Set up and connect via SSH access: the prerequisite for this method.
Still stuck?
Section titled “Still stuck?”If the archive does not complete or you are not sure which folders belong to your project: Open a ticket in the customer center.