To configure the publish settings for your project, click the Project Settings sidebar menu option, then Publish Settings. Then you will see this screen:
Upload Information
The first thing you need to do is provide SetupCast the information needed to upload the files to your webserver.
FTP Server - this is the name or IP address of your FTP server (just as you would use in your FTP program). It is usually better to use a name so that your project will not break if your ISP changes IP addresses.
Note: DO NOT ENTER A PROTOCOL (such as ftp://). Just enter the name like: www.mydomain.com
Base Directory - This is the Base Directory as it appears from the perspective of the FTP server.
This is an important piece of information since all directories created and URLs generated by SetupCast hang "under" this directory. If no base directory is provided, then these items are created at the "root" level of your webserver.
We strongly suggest that you read and follow the guidelines for Directory and Filename information and use a Base Directory.
Using a Base Directory makes it easy to manage the files uploaded on a "per product" basis. It also makes it easy to remove entire sets of files and directories if they are no longer needed.
For the purpose of this tutorial we suggest that you use a Base Directory of firstproject.
A special note about Linux/Unix type webservers:
If you are hosting your website in a data center that uses a Linux or Unix type webserver, then you may be required to provide an additional directory as a part of the path for uploading files that can be accessed via the HTTP protocol.
Typically this is a directory off the root of the webserver called public_html (note the lower case).
Your ISP or hosting center will tell you if this is required.
If you are supposed to upload files for the webserver into the public_html directory then you need to adjust your Base Directory in SetupCast to allow for it.
The Base Directory for our tutorial without this requirement would be:
firstproject
The Base Directory for our tutorial with this requirement would be:
public_html/firstproject
As you can see it is simply the public_html, then a / (forward slash) and finally the firstproject part of the URL.
A special note about case sensitivity and filenames
Some webservers (usually the Linux/Unix type) are sensitive about upper and lower case letters in filenames. You have to be careful with this or you will create a situation where you think you have a correct path to your files - yet you get an error from the webserver that the file can not be found.
SetupCast has an option in the Program Settings to "Convert Filenames and URLs to lowercase for publishing" as shown here:
If this box is checked then all filenames and URLs generated for publishing will be converted to lower case (regardless of how they appear in the program).
FTP User Login and Password - Use these fields to enter the FTP user login name and the password. Note that the password has to be entered twice as it is a masked field.
Note: The password is double encrypted before it is stored for security.
FTP Port - Enter the FTP port for uploads to your webserver (default = 21 )
Use Passive Connection - Select this option to enable a Passive connection to your server during FTP uploads. This is often a requirement these days due to firewall settings. Your ISP or hosting center can tell you if this is required.
Hint: If you are having problems with uploads, try changing (usually enabling) this setting. Sometimes this requirement may change after your initial publish (if your ISP changes hardware) and a simple toggle of this setting can get you going again.
Test FTP Connection
SetupCast has a button you can click after entering the information above that will test its ability to upload files.
We recommend that you run this test to make sure that SetupCast can access your server BEFORE you go any further.
Download Information
The next thing you need to do is provide SetupCast the information needed to download the files from your webserver. This information is used to construct the URLs written into the generated content.
Protocol - Select the protocol that users will need to download files from your website. Typically this is http:// (the default value).
Web Server - This is the name of the server where the files can be downloaded.
Note: DO NOT ENTER A PROTOCOL (such as http://). Just enter the name like: www.mydomain.com
Base Directory - This is the Base Directory as it appears from the perspective of the web server.
Another special note about Linux/Unix type webservers:
The public_html directory name that is a part of the path for uploading files is NOT a part of the path when downloading files so be sure that you do not enter it here.