Publishing to a Remote Host
The previous step of this process is "Choosing a Publishing Location."
Sandvox will ask you to enter your host settings like this:
Sandvox will automatically fill in fields based on previous settings when it can.
The address that visitors will view your site at. Generally, something like this:
If you are setting up a brand new website, your domain name may not yet point to your host (or you may not even have bought one yet!). If so, you can still enter the domain here and when Sandvox fails the connection test, just ignore it for the time being. We recommend that once the domain is properly connected you run the Host Setup Assistant again to ensure everything is correct.
Some hosts also provide a link to your account as a subdomain of their website and you could perhaps enter that URL here instead.
As you type the URL of your website, Sandvox tests it. There are, roughly three possibilities:
- Green light
- Sandvox was able to connect to a web server at the URL, and it appears to be behaving properly.
- Red light, redirect
Sandvox was able to connect to a web server at the URL, but it redirected somewhere else. This could be because:
- The domain is owned or registered by someone else. You'll need to pick another domain or purchase it from them.
- You've purchased the domain but still need to correctly set the DNS records for it.
- You've purchased the domain and set DNS records for it, but they just haven't had enough time to propagate yet. Try again later, or ignore the error.
- The URL is simply misspelt slightly.
- Red light, error
- Sandvox couldn't contact a web server at the URL. Some possible reasons are the domain not having been registered yet, a misspelling, or your internet connection being down.
Clicking on the arrow on the righthand side will open the URL in your default web browser.
- "Host name"
The hostname might be basically the same as the URL Format like so:
or to your hosting provider:
Hosts vary on how they handle the format for the server and the URL. You can refer to this help article for known quirks of specific hosts.
Protocol and Port
The method by which the site will be uploaded to your host. The available methods are FTP, FTPS, SFTP, and WebDAV (but not over SSL). In general, we prefer it if you use "SFTP" since it is more secure. However, your host may not support that. They should tell you which methods they support.
Note that these upload methods are not completely interchangeable. There may be some hosts where you can only access the directory you need to upload your files into via SFTP, not FTP. The reason for this is that FTP usually gives you access only to your personal home directory (and any files and folders in it), whereas SFTP generally gives you access to the whole computer's directory of files and folders (as long as your user account has privileges to access those!) And often with WebDAV, only certain directories can be accessed, perhaps not even your entire home directory. So if the directory where HTML files are served from is not in your home directory, SFTP may be the only solution.
Sandvox automatically fills in the "Port" field for you. You should only change this value if your host specifically requires you to.
- "Account ID"
- "User ID"
If you have chosen SFTP as your upload method, then you can check the "Use public key" box to use a public key instead of a password. Please see the "Uploading using SFTP" article for information on this.
You can check the "Show password" box, when you're sure no one is watching, to make sure that you're typing the password right.
If you know your document root, type it here. (This information should have been supplied by your host when you initially set up service.)
If you don't know the name of your document root directory, click the "Choose…" button.
It will take a moment for the next window to open. If all of the information you've entered is correct, the window that opens will show you the folders available to you on your external host. There should only be a few directories to choose from, and one of these is the folder in which your web site will be stored.
The document root is often, but by no means always a directory called "www". Your host may use a different name (such as htdocs, httpdocs, html, public_html, or web).
Sandvox allows you to publish more than one site to a single host. To do so, you publish each site to a different subfolder.
To publish to a subfolder:
- On the URL field, add "/" (if it doesn't have one already) to your main URL then type the name of the subfolder you want to publish to. You cannot use any incompatible characters, such as spaces.
Depending on your previous settings, Sandvox may auto-fill the Folder field to reflect the name of your subfolder. If it does not, there are two ways you can manually add the subfolder:
- If it is not there already, type your document root on the Folder Field. Then type "/" plus the name of the subfolder.
- Click the "Choose..." button then choose or create the subfolder within your document root folder.
Once this information has been entered, click the "Continue" button to move on to "Testing Your Connection."
Keywords: publish, publishing, remote, host, setting, settings, setup, set, up, set-up, step, steps, ftp, ftps, sftp, webdav, secure, url, format, hostname, host, name, upload, method, uploading, port, username, user, name, password, document, root, doc, sub, folder, subfolder, domain