This guide will explain how to upgrade to CloneDeploy 1.4.0 on Linux installations.

Upgrade Path

CloneDeploy minor upgrades are incremental. Only 1.3.x can be directly upgraded to CloneDeploy 1.4.0.



  • CloneDeploy 1.4.0 has removed installation support for 32-bit systems.  If your CloneDeploy Server is not 64-bit, DO NOT attempt to upgrade.
  • CloneDeploy 1.4.0 has deprecated all macOS support and removed all features relating to Apple or Munki.  In the unlikely event you are using CloneDeploy for Apple, you must not upgrade.
  • The Linux Imaging Environment has changed. If you are using the client iso / usb, you must generate a new one after the upgrade.
  • All Kernels prior to 4.18.5 will no longer work with CloneDeploy 1.4.0.  Kernels 4.18.5, 4.20.10 and 5.0RC7 have been included.


Backup / Export Database

mysqldump clonedeploy -v -u root -p > ~/cdbackup.sql


Retrieve Existing Password / Key

cat /var/www/html/clonedeploy/api/Web.config | grep clonedeploy

Make note of the uid and pwd values for the database connection string

cat /var/www/html/clonedeploy/api/Web.config | grep Encrypt

Make note of the DbEncryptionKey value


Update Application

mv /var/www/html/clonedeploy/ /var/www/html/clonedeploy.old
mv /tftpboot/ /tftpboot.old
wget " 1.4.0/clonedeploy-1.4.0.tar.gz"
tar xvzf clonedeploy-1.4.0.tar.gz
cd clonedeploy
mkdir /var/www/html/clonedeploy
cp -r frontend /var/www/html/clonedeploy
cp -r api /var/www/html/clonedeploy
cp -r tftpboot /


Recreate Symlinks

ln -s ../../images /tftpboot/proxy/bios/images
ln -s ../../images /tftpboot/proxy/efi32/images
ln -s ../../images /tftpboot/proxy/efi64/images
ln -s ../../kernels /tftpboot/proxy/bios/kernels
ln -s ../../kernels /tftpboot/proxy/efi32/kernels
ln -s ../../kernels /tftpboot/proxy/efi64/kernels


Repair Permissions(Ubuntu)

chown -R www-data:www-data /tftpboot /var/www/html/clonedeploy


Repair Permissions(CentOS)

chown -R apache:apache /tftpboot /var/www/html/clonedeploy 


Fix Mono Problem

sysctl fs.inotify.max_user_instances=1024
echo fs.inotify.max_user_instances=1024 >> /etc/sysctl.conf


Update Web.config

Open /var/www/html/clonedeploy/api/Web.config with a text editor and change the following values:

xx_marker1_xx to the password that was noted earlier
Uid=root to the user that was noted earlier
xx_marker2_xx to the DbEncryptionKey that was noted earlier

restart apache


Apply Web Interface Settings Changes

Login to CloneDeploy with an admin account.

Click Update when prompted to update the database.


Select Admin Settings->Image Profile Updater

Ensure the New Kernel says 4.20.10×64

Check all image profiles

Click Update Image Profiles


Select Admin Settings->Boot Menu

Click Create Boot Files


Fix ISO/USB Generation Bug

A bug in 1.4.0 has already been discovered that prevents the iso / usb generation from working properly.  To fix:


and place it in /var/www/html/clonedeploy/api/bin/ , overwriting the original.

in Upgrade To 1.4.0