Learn how to configure a new FTP, FTPS (FTP over SSL), FTPES (FTP over Explicit Auth SSL) or SFTP (SSH File Transfer Protocol) connection.
Tap on the File Transfer (globe) button in the Files section to open the File Transfer screen.
Tap on the + button (1) and choose (S)FTP Connection (2) to add a new connection.
Choose the "FTP (Unencrypted)" protocol.
Configure the connection by setting the host name (this can be a domain name like "example.com" or an ip address), a user name and a password.
Make sure that the host name does not include a protocol like "ftp://" or a slash after the host name.
You can also add a custom title that will appear in the connection list and choose another port than the standard port 21.
If you enter a path, Textastic will use this as the root path when connecting to the server.
Choose the correct character encoding you want to use for this connection. This setting depends on your server's configuration.
If you encounter connection problems with the standard "Passive (EPSV/PASV)" connection mode, try to use "Active (EPRT/PORT)" instead.
Enable the Show Hidden Files setting if you want to see hidden remote files like ".htaccess".
You can also try to enable the Debug Log setting. This will create detailed log files in the "logs" directory in Textastic. Note that this logs all traffic for this connection, so only enable this for debugging purposes and make sure to disable it again as soon as possible.
For FTPS / FTP over SSL connections, most settings are the same as for regular FTP connections (see above). Notice the different default port 990.
You can also choose FTPES (FTP over Explicit Auth SSL) as protocol which defaults to port 21.
FTPS adds an option that allows you to choose if Textastic verifies the SSL certificate of the server. Disable this if you use a self-signed certificate on the server.
SFTP (SSH File Transfer Protocol) is a subsystem of SSH (Secure Shell). You can use this connection type to securely transfer files between your server and Textastic. For more information have a look at SSH File Transfer Protocol (Wikipedia)
The default port for SFTP connections is 22.
Textastic usually switches to the root directory after establishing an SFTP connection. If you want to start at the user's home directory instead, enter "~/" in the Path field.
Textastic supports user/password authentication as well as public key authentication.
1. User/Password authentication
Enter your user name and password as you would for a regular FTP connection, but disable the Public Key Auth. setting.
2. Public Key Authentication
Enter the user name.
Enable the Public Key Auth. setting. Now you can enter the path to the private key file.
The standard settings expect a private key file named "id_rsa" in the "ssh" subfolder in Textastic (see screenshot). If you used iTunes File Sharing, the file will be in the root folder, so you can either enter "id_rsa" as the private key file path or move the file to a subfolder.
If your private key file is protected with a passphrase, Textastic uses the password setting to retrieve the private key.
Textastic expects the key file to be in the format used by the OpenSSH utility "ssh-keygen". If you instead have a key in PuTTY's format (.ppk), you can use PuTTYgen to convert it to OpenSSH format:
Visit the PuTTY website and download puttygen.exe (on your PC). Open it, and using the File menu, load your .ppk that you already use, and type in your passphrase. Now go to the Conversions menu and export the key as an OpenSSH key. You can now use the converted key with Textastic.
If you encounter connection problems, you can enable the Debug Log setting. This will create detailed log files in the "logs" directory in Textastic. Note that this logs all traffic for this connection, so only enable this for debugging purposes and make sure to disable it again as soon as possible.