FTP access
FTP access is made for shared hosting, which often does not offer SSH. With it, Copilot browses the store’s code and uploads, file by file, the changes you approve — when the module and the API are not enough.
Before you start
- FTP access is open to every plan, Essential included: no developer mode is needed.
- You need the FTP server address, a username, a password and the store’s folder on the server. Your host provides them in its customer area.
Creating a dedicated FTP user
Do not give Copilot the main login of your hosting: create a user reserved for Copilot, limited to the store’s folder. You remove it in one click when you no longer want the access, without touching anything else.
The screens differ from one host to another: if a label differs, look for the “FTP” section of your customer area.
- Name:
copilot(or a name you will recognise). Password: long and unique, used nowhere else. - Folder: the store’s (where
index.phpand thethemesfolder are), and only that. - Rights: read and write in that folder. No right to manage other accounts or other sites.
At OVH (web hosting): in the customer area, open Web Cloud, your hosting, then the FTP - SSH tab. Click Create a user, give it a name, a password and, as root directory, the store’s folder. The server address and port are shown in the same tab.
At o2switch (and hosts with cPanel): in cPanel, open FTP Accounts, then Add FTP Account. Enter the name, the password and, under Directory, the store’s folder. The account’s Configure FTP Client link gives the server to use for the encrypted connection.
At Ionos: in the customer area, open your hosting, then the FTP and SSH (or SFTP and SSH) section and create a user limited to the store’s folder. Check that your plan offers FTP or FTPS: some offer only SFTP (port 22), which Copilot’s FTP access cannot use. In that case, use the module or SSH access if your plan allows it.
With most shared hosts, a user limited to one folder sees that folder as its root. In Copilot, then enter / as the root folder — and not the system path the host’s panel shows (/home/…): the server does not know it from your account.
Setting up access
- In the store settings, open FTP access.
- Fill in the FTP server, the Port (21 most of the time), the FTP user and the FTP password.
- Enter the Shop root folder: often
public_html,wwworhtdocs. Copilot never goes outside this folder. - Read the warning and tick the box: what Copilot writes over FTP really runs on your shop, under your responsibility. Make backups before writing and work on a staging copy first when you have one. You accept it once per shop; the date of your agreement is recorded.
- Enable the access, save, then click Test the connection.
The server certificate
Copilot always tries an encrypted connection (FTPS) first. On the first test, it shows you the fingerprint of the certificate presented by the server, before sending any password. Compare it with the one your host gives, then accept it. If this certificate ever changes, Copilot refuses to connect and tells you so.
Browsing files
Once the connection has been tested, the file browser shows the store’s code in read-only mode: folders, files, the content of text files.
Changing a file
Changes are requested in the conversation: “Add this rule to the .htaccess file”, “Fix this line in the footer template”. Copilot reads the file, prepares the change and shows the lines that change. You approve; the file is written; the old content is kept for the Undo button.
Copilot writes one file at a time, and deletes no file over FTP.
What Copilot does over FTP, and what it never does
What it does
- Browse folders and read text files (up to 512 KB), read-only.
- Write one file at a time, after your approval: it uploads it, reads it back to check the server received exactly what was sent, and keeps the old content for the Undo button.
- Tell you plainly when the server refuses (rights, missing folder, full disk, connection too slow) instead of letting you think it is done.
What it never does
- Delete a file or a folder. The only removal possible is that of a file Copilot has just created itself, when you click Undo.
- Create, rename or move a folder, or change permissions.
- Read or send a binary file (image, archive, database) or one larger than 512 KB: it tells you so.
- Leave the root folder you gave.
- Write without your approval: an FTP write is never automatic, even if you asked not to be prompted for other actions.
- Connect in clear text unless you chose it, or send your password to a server whose certificate is unknown or has changed without your acceptance.
- Show or send back your password: it is stored encrypted and appears nowhere.
Removing access
The Delete FTP access button erases the saved password and certificate.