

<pre>
CrushFTP 8 is a separate install, and requires a CrushFTP 8 license code.  Prior CrushFTP versions require purchasing an upgrade code to use in CrushFTP 8. [http://www.crushftp.com/pricing.html].  Download a fresh copy of CrushFTP 8 and extract it to a safe location. [http://www.crushftp.com/download.html]
----

Video covering the upgrade process: [https://youtu.be/j4CAXYvDCm0]

!CrushFTP 6/7 Upgrade to CrushFTP 8 (scroll down below for upgrades from older versions):

1.) Run CrushFTP 6/7 and click 'Remove Daemon / Service'\\
2.) Copy over your users folder, prefs.xml, ssh private keys, and ssl keystores files from the old version to the new version's folder (see followup items below).\\
*Do not replace your WebInterface folder, the CrushFTP 8 WebInterface folder is very different, and replacing it with the older folder would break CrushFTP 8.\\
[attachments|gui_setup.png]\\
3.) Click &quot;Start Temporary Server&quot;.  The server will now be running and ready for use as long as you keep this window open.\\
4.) Login using the web browser to your server using your normal 'crushadmin' user.  Go to the Admin, About tab and enter in your CrushFTP 8 license code.\\
5.) Go back to the GUI window, and click 'Install Daemon / Service'\\
6.) Update any paths in the prefs for SSH keys or SSL keystores to point to your new CrushFTP 8 folder.

----

!!v6/v7 to v8 Followup items:\\
Copy over your TempAccounts folder if you have been using the WebInterface 'Share...' feature.\\
\\
Copy over your Previews folder so image previews don't need to be re-generated.\\
\\
Copy over any custom logo images from your WebInterface folder, but do not overwrite any login.html files as CrushFTP 8 is different.\\
\\
Copy over your SSL keystore if you had it in your CrushFTP folder, and update the prefs to point at the new location.\\
\\
Copy over your private SSH key files for the server if they are in their default location.  (ssh_host_rsa_key, ssh_host_dsa_key)\\

----
----
!CrushFTP 4 or CrushFTP 5 Upgrade to CrushFTP 8:

1.) Run your prior CrushFTP version, and uninstall the daemon or service if its installed.

2.) Copy over your users folder, and prefs.xml file from the old version to the new version's folder.

! *Do not replace your WebInterface folder, the CrushFTP 8 WebInterface folder is very different, and replacing it with the older folder would break CrushFTP 8.

3.) Run CrushFTP 8.

[attachments|gui_setup.png]

4.) Click Create New Admin User.  Create your own admin user that will be used for managing the server.  Call it 'crushadmin'.

5.) Click &quot;Start Temporary Server&quot;.  The server will now be running and ready for use as long as you keep this window open.

6.) Login using the web browser to your server using the 'crushadmin' user you just created.  Click the 'Admin' button in the upper left.

7.) Go to Preferences, and click on each server item.  Verify to the right that each port (FTP,HTTP,SFTP) is set to use users from the correct User Connection Group.  (Probably &quot;MainUsers&quot; or &quot;lookup_21&quot;.)

[attachments|user_connection_group.png]

8.) Open the user manager, select the Convert All Users from the convert menu.  (If you were already using CrushFTP 5.5 and above, this can be skipped.)

[attachments|convert_users.png]

9.) Test and verify things are working on the new server.  If necessary, you can add or remove server groups in the [IP Servers] of the server prefs.

10.) Install the daemon / service again using the main CrushFTP application.


----

!!Followup items:\\
Copy over your TempAccounts folder if you have been using the WebInterface 'Share...' feature.\\
\\
Copy over your Previews folder so image previews don't need to be re-generated.\\
\\
Copy over any custom logo images from your WebInterface folder, but do not overwrite any login.html files as CrushFTP 8 is different.\\
\\
Copy over your SSL keystore if you had it in your CrushFTP folder, and update the prefs to point at the new location.\\
\\
Copy over your private SSH key files for the server if they are in their default location.  (ssh_host_rsa_key, ssh_host_dsa_key)\\
  ''On OS X, these are in the app bundle.  CrushFTP5.app/Contents/Resources/Java/''\\
  ''On CrushFTP4, you only had a DSA key located in the &quot;conf&quot; folder.  CrushFTP4.app/Contents/Resources/Java/conf/''

----
!!CrushFTP4 upgrade troubleshooting tips.


v4 has a bit of a mess on its user connection groups.  So when you look in the folder &quot;users&quot; you see MainUsers, lookup_21, lookup_80, etc.

Figure out which ones are correct.  MainUsers is the default location since v5.  But you can use the other named folders just fine too.

In the prefs, on the tab with the list of ports, down at the bottom is a list of the user connection groups.  Remove or add them as appropriate to match up with the real ones you have based on the folder names in the users folder.

Then on each port, check to see what user connection group they are configured for.  Assign them appropriately.

If you haven't done this then logins may fail when you start using CrushFTP8 as it can't find the users since they aren't associated to the port you are using.

</pre>