Knowledgebase

Moving your site to another folder on your server

1. Determine the new foldername where your Zen Cart® files will be running from
2. Go into Admin > Configuration > Sessions and change the Session Directory to reflect the new folder name. If you cannot do this, see the alternate approach in step 5 below.
3. Move/Rename the folder. You may need to use your FTP program to do this.
4. Your /includes/configure.php and /admin/includes/configure.php files are used to point Zen Cart® to the right folders. In that file, you need to update several entries to match the new path information:
   
   • DIR_WS_CATALOG
   • DIR_WS_HTTPS_CATALOG
   • DIR_FS_CATALOG
   • DIR_FS_LOGS (since v1.5.0)
   • DIR_FS_SQL_CACHE 
     
     And in older versions (ie: v1.3.9h and older) you'll need to also adjust these in your /admin/includes/configure.php file. They don't need adjusting in v1.5.0 or newer:
   • DIR_WS_ADMIN
   • DIR_WS_HTTPS_ADMIN (in admin)
   • DIR_FS_ADMIN (in admin)
   
   Note that the configure.php files are normally "read-only". You'll need to change their permissions to "writable" before you can upload your changes. Be sure to note level the permissions were at before changing, so that you can put them back to the read-only permissions again after updating.
5. If you could not set the Session Write Directory in step 1 above, you can use a utility to do it for you. The goal is to make sure that the new path information (specifically the DIR_FS_SQL_CACHE setting in your new configure.php file) matches theSession Write Directory setting. If it doesn't, you may end up with difficulties logging in to the Admin area or maintaining login sessions in the store. The Fix Cache Key Utility from the Plugins > Troubleshooting Tools area on the main Zen Cart® site will help you to do this if you need assistance. There is no harm running it to have it check that things are set properly. Be sure to delete the file from your server when done.