Connecting to your site using sFTP
Updated on 20-October-2016 at 10:16 AM
Using SSH File Transfer Protocol (SFTP), you can upload large quantities of files to your site, including web pages and images.
If you are new to working with FTP/SFTP, see SSH File Transfer Protocol on Wikipedia.
Understanding SFTP clients
There are many free third-party SFTP programs that you can download and use for free. Note that some are platform-specific, ensure that you download the software that matches your operating system. A partial list is provided below:
- Cyberduck - Mac OS X, and Windows
- sFTP Client - this sFTP client is a Chrome extension
- FileZilla - Linux, Mac OS X, and Windows
- sFTP Client - Turbo FTP client & SFTP client
- SmartFTP - Windows only
- WinSCP - Windows only
- Transmit - MAC OS X
You can find other SFTP clients by searching on the following terms using your favorite search engine: Download free FTP client.
Note: There are some SFTP clients that are incompatible with the system. These SFTP clients, such as Expresso or Transmit FTP, delete and reupload a file instead of overwriting. This method leads to lost metadata from the our service.
If you have issues with modules such as content holders creating a new ID every time you upload, try switching to one of the above supported SFTP clients.
SFTP account details
There are a number of FTP clients you can use to connect to your site. Regardless of the client you use, the SFTP connection details for your site are as below:
- Host name - dealer.worldsecuresystems.com
- Protocol - SFTP / SSH File Transfer Protocol
- Port - 22
- User name - dealer.worldsecuresystems.com/jdoe@mailcom/dw
- Password - Your admin login password
- FTP mode (if necessary) - Passive
Note: Ensure that you follow the below guidelines using the above SFTP account details:
- Replace "dealer.worldsecuresystems.com" with your site's domain name.
- Replace "firstname.lastname@example.org" with the email address you use to log in to the admin of your site. Do not forget to add /dw at the end of the username
- Do not append http:// to the host name or user name
- If your site is still a trial/temporary site and you have not added your own domain just yet, use your system URL (yoursite.worldsecuresystems.com).
If you are still unable to connect, verify that the network you are using does not have a firewall set up (such as a corporate office or a government agency). This type of network security could result in FTP connection issues. If you suspect that you are behind a firewall, try connecting outside the office, using a different network.
SFTP server fingerprints
Some clients may also ask for the SFTP server fingerprint to validate the connection. Depending on which data center your site is hosted on, use the below SFTP key fingerprints:
ssh-dsa 1024 ae:3f:26:16:01:4c:7a:3a:2b:57:2d:ae:1d:b2:d9:c7
ssh-rsa 1024 22:84:42:39:2f:d9:5a:5c:74:ab:99:c8:f5:4b:ce:0f
ssh-rsa 1024 23:92:92:63:c6:74:dc:63:ca:00:9b:28:d5:29:3a:4c
ssh-dsa 1024 b2:2b:bb:9c:f3:8d:2b:fe:3c:1e:0c:1f:75:c1:53:7c
ssh-rsa 1024 5d:39:4f:9b:5b:d6:e2:e0:99:47:02:e3:c9:1a:a8:9d
ssh-dsa 1024 28:82:6a:b9:e7:4f:95:78:40:1c:00:47:b5:d4:de:18
Supported file types
The SFTP service for this system supports uploading files that use the following file extensions, among others:
- .htm and .html
- Images (.gif, .jpg, .png)
- Flash files (.swf)
- Media Files (.rm, .wma, .mp3, .flv)
You can also upload these file types using the File Manager in the Admin Console.
Many other file types are allowed, so try uploading your file first, to see if it works. If you cannot upload a file type that you think should be supported, contact the Support team with your request.
Why do I need to add "/dw" at the end of my username?
The correct username is email@example.com /dw. If you omit the " /dw" part the sFTP client will connect to the site in "plain" mode and will disregard associations between pages and templates.
The system however will keep these associations on the BC side so what will happen will be something like this:
- the sFTP client (provided the username does not have " /dw" added in the username) will request a particular page that has a template attached
- BC will serve that page
- the sFTP client uploads the page back
- BC will take the page but will not know how to unpack it (extract the content of the page), it will leave the page untouched (including the HTML content of the template which has now been merged with the body of the page)
- when it comes to rendering the page the system will render the content received (including the bits that belong to the template) plus the template associated to that particular page.
- the result is the page content will be wrapped in the template twice.
If you configure the sFTP client to connect to the site using " /dw" added to the username at step 4 above the system will know how to interpret the HTML code of the file as template HTML code and not cause the "duplication".