Our experts are always on hand to help answer your questions, get you started, and grow your presence online. You can email us any time
This tutorial shows you how to connect to your onion service over SFTP with WinSCP, the most common SFTP client on Windows, and how to download your logs and upload your website files over the Tor network. The settings are the same as in the FileZilla guide — only the windows are different.
In the Customer Portal, open your onion service and click File Manager. At the bottom of that page the SFTP Credential card holds the four values the client asks for: the host name (your ….onion address), the user name, the password and port 22.
First, connect the Tor network: start the Tor Browser (if you have not installed it yet, download it from torproject.org) and let it connect. The Tor Browser runs a SOCKS proxy on 127.0.0.1:9150, and that proxy is what WinSCP will use — it is the only way a .onion name can be resolved.
WinSCP is free and only exists for Windows. Download it from winscp.net; the "Portable executable" download is enough — it needs no installation and no administrator rights. You can use any other SFTP client instead, but the fields below are named after WinSCP's.
WinSCP takes the proxy per site, not globally, so start from the login window: New Site in the left column, then click Advanced… at the bottom of the window.
In the advanced settings open Connection → Proxy and fill it in like this:
SOCKS5127.0.0.19150
Click OK to close the advanced settings. The proxy now belongs to this site — which is why you want to save the site rather than retyping it every time.
Back in the login window, fill in the four values from the SFTP Credential card on the File Manager tab:
SFTP (not SCP, not FTP)….onion address22 — the SSH server inside your container, not the port of your websiteClick Save to keep the site (proxy included), then Login.
One prompt is specific to WinSCP: while connecting it asks for a Proxy username and Proxy password. Tor advertises that a SOCKS proxy may carry credentials, WinSCP offers them, and Tor then asks for them — although it accepts anything, because the values are only used to separate streams. Leave both fields empty and click OK; the connection continues.
WinSCP cannot know yet that the onion address really is your container, so on the first connection it stops with "Continue connecting to an unknown server and add its host key to a cache?" and shows the fingerprint of the container's SSH key. That is expected with a .onion address — no certificate authority signs those keys. Click Accept (older versions label the button Yes) to accept the key and to cache it, so you are not asked again for this host.
PuTTY shows the same warning ("The server's host key is not cached"), FileZilla words it as "The server's host key is unknown" — same check, same answer.
After the login WinSCP opens its two-pane (Commander) view: your own computer on the left, the container on the right. The remote side lists the folders of the service:
www — the web root. Anything you upload here is served by your onion site.logs — the Apache access and error logs of the site.backup — the place the service keeps its own archives.The status bar shows Connected and the remote path; dragging a file between the panes uploads or downloads it, and the transfer queue at the bottom shows the progress and speed. If the connection drops, reconnect from the same saved site — the session is reused, including the proxy.
The proxy setting belongs to that one site, so it does not affect your other FTP connections. If you also use this site entry for something else, or if you later cannot reach a normal server from WinSCP, open Advanced → Connection → Proxy for that site and set Proxy type back to None. Do the same in any other client where you configured 127.0.0.1:9150 globally: with the Tor Browser closed there is no proxy on that port, and every connection then fails.
Each onion service has its own credentials, so give each one its own saved site (New Site → name it after the service → Save). The proxy can be copied between them: in the login window, right-click a saved site and choose Duplicate, then change only the host name, user and password.
Our experts are always on hand to help answer your questions, get you started, and grow your presence online. You can email us any time