Publishing to a Remote Host

Previous Step

This article is part of the "Setting Up Your Host" procedure, and is for you if you are publishing your site to a remote host.

The previous step of this process is "Choosing a Publishing Location."

Host Settings

Sandvox will ask you to enter your host settings like this:


Remember that all of the settings you need to set up your site for publishing should be provided by your host. You may need to contact them if you are missing anything.

Sandvox will automatically fill in fields based on previous settings when it can.

URL

The address that visitors will view your site at. Generally, something like this:

http://www.example.com

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.

Server

The address of the server to connect to when publishing your site. Your host might instead refer to this as:

The hostname might be basically the same as the URL Format like so:

example.com

or to your hosting provider:

examplehost.com/john

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: To enable FTPS, you need to open the Preferences window and choose the FTP system of "Modern, with TLS/SSL support when available".

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.

Username

Your username for logging into the Host server. Your host may instead refer to this as:

Password

Your password for logging into the Host server.

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.

In order to store your password securely, it is recommended that you keep the "Remember in my keychain" box checked.

Folder

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).

Subfolder

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:

or

Next Step

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

How can we improve this page? Let us know.