SFTP / SSH
PremiumThe SFTP / SSH page connects you to your servers over SSH. A terminal, an SFTP file manager, sync pairs, an editor and the server's databases sit together in one tab per session. SSH is the encrypted remote access to a server, SFTP the file transfer over the same connection. The page is the first entry of the Remote group in the sidebar and is part of Premium.
What you do here
- create, organise and open connections to your servers
- work on several servers at once with sessions and tabs
- run commands right on the server in the terminal
- see in server software which versions of PHP, web server and database run there
- transfer, create, rename and delete files between your Mac and the server
- sync folders with sync pairs, with a preview and undo
- open files in the editor and save them straight to the server
- browse and edit the server's database below the editor
Page layout
At the top is the heading Remote with the notice Caution: working directly on the server (see below). Below it the page splits:
- On the left the Connections list with New, search and projects. Once a session is open, Collapse shrinks the list to a narrow strip, Show connections brings it back.
- On the right the open sessions as tabs. Without a session it says No active session.
A tab consists of these cards, from top to bottom:
- Terminal: the shell on the server, with
user@hostin the header and the Server software line below it. - Sync: your sync pairs for this server.
- Files: Local (your Mac) and Remote (the server) side by side, with the running Transfers below.
- Editor: the open file.
- Database: only when you have added a database for this server.
Drag the grip at the bottom edge of the terminal, files, editor and database card to change their height. Double-clicking the grip restores the standard height. The last card of the tab has a grip at its top edge too, so it can grow even at the end of the page. The page scrolls as a whole, the terminal, file lists and editor scroll inside.
Terminal, files, sync and editor run over one SSH connection per tab. You log in once.
The pages of the Remote group
| Sidebar entry | What for |
|---|---|
| SFTP / SSH | connections, terminal, files, sync, editor |
| Databases | browse and edit tables, run SQL, back up and restore |
| Backups | archive a server's folders and databases, also on a schedule |
| Cron jobs | schedule commands and scripts on the server |
| Logs | follow the server's log files |
| read the mailboxes of your domains and write mail | |
| Fetch locally | bring a project and its database from the server to this Mac, also in Free |
All pages share the same saved connections. The server you last connected to here is preselected on the other Remote pages.
The notice "Caution: working directly on the server"
Remote works directly on the server, with real files, databases and credentials. That is why the notice sits at the top of every Remote page and as a slim strip in every dialog that connects to a server or writes or deletes there.
- More expands the full text.
- Got it hides the strip at the top of the pages until you restart WebDonkey.
- Don't show again turns the notice off entirely. You turn it back on under Settings › General with Remote notices.
The confirmations before deleting and overwriting do not depend on this switch, they always come.
Free and Premium
SFTP / SSH is part of Premium. Without Premium the page is covered by Remote is a Premium feature with the way to unlock it.
Two things also work in Free:
- The shells for Docker containers and DDEV projects that you open from the Sites page show up as tabs on this page.
- Fetch locally is a page of its own in the Remote group and free.
Connections Premium
A connection is the saved access to a server: address, user and the way you log in. You create it once and then use it on every Remote page, for the terminal, files, backups, cron jobs, logs, mail and databases of that server.
Where to find it
Sidebar Remote › SFTP / SSH. The Connections list is on the left of the page.
How to do it
- Click New in the header of the Connections list. The New connection dialog opens.
- Fill in Name, Host and Username. Port is set to
22. - Under Authentication, choose how you log in: Password, SSH key or SSH agent (see below).
- Fill in the optional fields if you need them.
- Click Save.
The connection is now in the list. Connect opens it in a new tab.
Import from ~/.ssh/config
If your ~/.ssh/config has hosts, a new connection shows the field Import from ~/.ssh/config at the top. Pick an entry under Choose a host …. WebDonkey takes the address, port, user and the key or agent from the entry, and the name only if that field is still empty.
If your configuration reaches the host through a jump host (ProxyJump), the entry carries an arrow and a note appears below. WebDonkey connects directly and cannot use the jump host. The connection then only works if your Mac reaches the server itself.
Your input is kept
If you close the dialog of a new connection without saving, what you typed is kept, the password included. New connection shows it again next time. Reset inputs at the bottom left starts over. Editing an existing connection always starts from what is saved.
Fields and options
| Field | Meaning |
|---|---|
| Name | Display name in all lists. Required. |
| Host | Address or name of the server, e.g. example.com. Required. |
| Port | SSH port. Default 22. |
| Username | SSH user, e.g. deploy. Required. |
| Authentication | Password, SSH key or SSH agent. Default Password. |
| Private key file | Only with SSH key: pick a key from ~/.ssh under Choose a key … (the same list as the SSH keys in the terminal) or a file via Browse. |
| Key passphrase | Only with SSH key: the passphrase, if the key has one. |
| Password | Only with Password: the user's password. |
| Agent socket (optional) | Only with SSH agent: the socket of a particular agent (such as 1Password or Secretive). Empty uses the default agent. |
| Start folder (optional) | The folder the Remote pane starts in, e.g. /var/www. Empty is the home folder. |
| Colour mark | None, Red (production), Orange, Yellow, Green, Blue, Purple or Grey. Red marks a production server (see below). |
| Homepage (optional) | The web address that belongs to the server, with http:// or https://. A button for it appears in the list and in the terminal header and opens it in the browser. |
| Project | Group in the list: No project, an existing project or New project … with a name. |
The eye in the password and passphrase field shows and hides the content.
Below the fields it says: Databases are no longer part of the connection. You add a database of the server under Remote › Databases.
The red colour mark
A connection with the red colour mark counts as a production server. The question before deleting on the server names it in red as Production server, the sync preview warns that every change goes live right away, and WebDonkey Editor never deletes there automatically but always shows the preview first.
The list of connections
Each row shows the name, the homepage button, the login type (SSH key for a key file, otherwise Password) and user@host:port. With sessions open, n open follows and the row is highlighted.
| Button | Effect |
|---|---|
| Connect | opens a session in a new tab. With one already open it reads Open another and starts a second, independent session. |
| Pencil (Edit) | opens Edit connection |
| Folder (Assign project) | puts the connection in a project, takes it out (No project) or creates a New project … |
| Bin (Delete) | deletes the connection after asking |
Search and organise
- Search connections… filters by name, user, host and homepage. Matches are highlighted, and a project with matches opens while you search.
- The folder icon with a plus next to the search creates a New project.
- You open and close a project with its heading. The pencil and bin next to it are Rename project and Remove project. Removing only drops the assignment: the connections stay, nothing is deleted on the server.
Edit and delete
When you edit, the password or passphrase field is filled with the stored secret. Leave it as it is and it stays. Empty the field and save, and the stored secret is deleted. If the secret could not be read, the field stays empty and shows Leave blank to keep the stored secret.
If you change Host, Port or Username, the connection points to another server. Open tabs of this connection are then closed, so no tab keeps working with the old server.
Delete connection asks Delete the connection "…"?. Along with the connection, WebDonkey removes its database entries, sync pairs, backup sets, remote logs and the entries of its cron jobs. Nothing is deleted on the server, and backup archives already on your Mac stay.
When the server does not know the key yet
If the server turns down your key but offers a password login, The server does not know this key yet opens. Usually the public key is simply not on the server yet.
- If the server is not in
~/.ssh/known_hostsyet, the dialog shows the fingerprint of its host key. Compare it and tick The fingerprint matches, trust this server. - Enter the user's password.
- Click Add key and connect.
WebDonkey adds the public key to ~/.ssh/authorized_keys on the server, like ssh-copy-id, and then connects with the key. The password is not saved. Under Rather in the terminal? you find the command that does the same.
Host key changed
On the first connection WebDonkey remembers the server's host key. If the server later shows a different one, the connection stops and the Host key changed dialog shows the new fingerprint. This can mean the server was reinstalled, or that someone is intercepting the connection. Only click Trust new key if you expected the change.
What happens in the background
- WebDonkey stores passwords and passphrases encrypted on your Mac, never in plain text.
- WebDonkey keeps the host keys of your servers itself. It reads your
~/.ssh/known_hostsonly when it adds a key, and then adds the confirmed server to it. - When you save a changed connection, WebDonkey uses the new details for the next connection.
Troubleshooting
| What you see | Why | What you do |
|---|---|---|
| Could not connect to the server | Wrong host or port, server not reachable | Check host and port, cross-check with ssh in the terminal |
| Login failed or The server rejected the login. | User, password or key do not match | Check the details, enter the passphrase for a key that has one |
| The key file could not be loaded | Wrong path or not a private key | Pick the key again |
| The saved password can no longer be read | The key to decrypt it is missing, for example after restoring an app backup | Edit the connection and enter the password again |
| Saving or deleting is refused with a note about scheduled tasks | WebDonkey still has active cron jobs on the server | Pause or delete them under Remote › Cron jobs, then try again |
| The homepage must be a web address (http:// or https://). | Address without http:// or https:// |
Enter the full address |
A host from ~/.ssh/config times out |
It is reached through a jump host | Make the server reachable directly or work in the terminal |
See also
Sessions and tabs Premium
Every open connection becomes a tab above the terminal. That way you work on several servers side by side, or with several sessions on the same server. A tab keeps everything you have open in it, even when you switch to another tab or another page of the app.
Where to find it
Sidebar Remote › SFTP / SSH. The tabs are at the top right, above the terminal.
How to do it
- In the Connections list, click Connect for a server. A new tab named after the connection opens and becomes active.
- Need a second shell on the same server? Click Open another there. The second session is independent of the first, with its own terminal and its own folder view.
- For a tab to another server, click the dashed + button after the tabs. It opens the connection list, where you pick the connection.
- Switch with a click on the tab.
Hovering over a tab shows user@host.
What a tab keeps
All tabs stay open in the background. When you switch, these stay as they are:
- the terminal history and running programs,
- the open folders in Local and Remote,
- the file in the editor, unsaved changes included.
This also holds when you go to another page of the app and come back. A yellow dot on the tab marks unsaved changes in the editor.
Close a tab
The x on the tab asks Close tab? for an SSH session. Close tab disconnects the session and closes the tab. If the tab has unsaved changes in the editor, the dialog says they will be lost.
A shell for a Docker container or a DDEV project closes without asking, unless its editor has unsaved changes.
Room for the tabs
Once a tab is open, the Connections list has a Collapse button in its header. The list then shrinks to a narrow strip with the server of the active tab. Show connections brings it back.
What happens in the background
- Every tab has its own SSH connection. Terminal, files, sync and editor of a tab share this one connection.
- The server you connected to last is preselected on the other Remote pages (Databases, Backups, Cron jobs, Logs, Mail and Fetch locally).
- Clicking a connection in the dashboard widget SFTP / SSH opens it here. If it is already open, its tab comes to the front instead of a second session.
Troubleshooting
- The session has ended.: The server dropped the connection or the Mac was asleep. Close the tab and connect again.
- A tab disappears after saving a connection: you changed its host, port or user. WebDonkey then closes the tabs of that connection, so no tab keeps working with the old server.
See also
Terminal Premium
The Terminal card is a real interactive shell on the server, the same as ssh user@host in your Mac's terminal. Type commands, start top or htop, follow logs with tail -f or edit files with vim.
Where to find it
Sidebar Remote › SFTP / SSH, then Connect on a connection. The terminal is the top card of the tab.
How to do it
- Connect to the server. The terminal opens with the user's shell.
- Click into the terminal and type your command.
- Drag the card taller at the grip at the bottom if you want more lines. Double-clicking the grip restores the standard height.
What the card shows
- Header: Terminal on the left,
user@hostas a green status mark on the right. If the connection has a Homepage, a button in front of it opens it in the browser. - Server software: the line below the header with the versions of PHP, web server and database, see Server software.
- Shell: in colour, fits its rows and columns to the size of the card.
The history stays when you switch tabs or pages. Switching between the light and dark theme keeps the shell running too, so a running update or migration is not interrupted.
Docker and DDEV
On the Sites page you open a shell in a Docker container or a DDEV project. It shows up as a tab of its own on this page, with Docker or DDEV and the name in the status mark. These shells work without Premium.
- A DDEV tab has a local file manager in the project folder and an editor below the terminal, but no Remote pane.
- A Docker tab is only the shell. The files live inside the container.
What happens in the background
The terminal runs over the same SSH connection as the files, sync and editor of the tab. You do not log in a second time. When you close the tab, the shell on the server ends.
Troubleshooting
| What you see | What you do |
|---|---|
| The terminal no longer responds | The connection is probably gone. Close the tab and connect again. |
| You need a second shell on the same server | Open another in the connection list starts an independent session, see Sessions and tabs. |
| Lines wrap wrongly | Change the card's height briefly, and the terminal fits itself again. |
See also
Server software Premium
The Server software line below the terminal header shows which programs run on the server and in which version: PHP, Node.js, web server, database and cache. Next to each version is a mark that says whether it is still supported. So you see without a single command whether a server needs an update.
Where to find it
Sidebar Remote › SFTP / SSH, open a connection. The line sits in the tab below Terminal and user@host.
How to do it
- Connect to the server. As soon as the tab is visible, the line briefly says checking ….
- Then it lists the programs it found, with version and mark.
- Hover over a mark to see the reasons, or over a name to see the program's path on the server.
- If you updated something on the server, click the circular arrow on the right, Check again.
What the line shows
WebDonkey looks for these programs:
| Name in the line | Program |
|---|---|
| PHP | php, also several versions side by side |
| Node.js | node, also from nvm |
| nginx, Apache, Caddy | the web server |
| MySQL, MariaDB, PostgreSQL | the database server |
| Redis, Valkey | the cache |
If WebDonkey only finds a database's command line program and no server, (client) follows the version. The database then probably runs on another machine, and the version is that of the program.
If it says nothing known found, the server has none of the programs under their usual names and paths.
The marks at the versions
| Mark | Meaning |
|---|---|
| Supported | The version line gets updates. |
| Update available | There is a newer version of the same line. |
| Security fixes only | The line gets no more bug fixes, only security fixes. |
| Support ends soon | The end of support is close. |
| Vulnerable | A newer version of this line closes a known hole. |
| EOL | No more updates, not even security fixes. |
The tooltip names the line, the dates of the end of support and of security fixes, the newer version, LTS and the recommended line. In a narrow card the marks shrink to coloured dots. If WebDonkey does not know a version, no mark appears next to it.
What happens in the background
- WebDonkey sends one command over the tab's SSH session. It asks the programs that are there for their version (
--version,-vorversion), also at the usual places of Plesk, cPanel and versioned PHP and PostgreSQL installs. - Nothing is installed, written, started or reloaded on the server. PHP runs without
php.iniand without extensions for this. A missing program is skipped silently. - The result is kept for 6 hours per connection. A new tab to the same server uses it instead of asking again. Check again asks right away.
- The marks come from WebDonkey's version status (endoflife.date and the vendors). Only product names go over the network for this, nothing about your server.
Settings
Under Settings › General, Fetch version status switches the requests off. With it off, the versions stay in the line, but without marks.
Free and Premium
The line belongs to the SFTP / SSH page and therefore to Premium.
Troubleshooting
- The line is missing: the tab's session has ended. Close the tab and connect again.
- A version without a mark: the version status does not know it, or Fetch version status is off.
- A program is missing: it is neither in the SSH user's search path nor in one of the usual places. Check in the terminal with
whichand the full path.
See also
Files Premium
Below the terminal, two file panes sit side by side: Local shows your Mac, Remote the server over SFTP. You move through folders, transfer by dragging or right-clicking, create files and folders, rename, set permissions and delete.
Where to find it
Sidebar Remote › SFTP / SSH, open a connection. The file panes are the third card of the tab, below Sync.
How to do it
Upload a file to the server:
- In the Local pane, go to the folder with the file.
- In the Remote pane, go to the target folder.
- Drag the file from Local to Remote. Drop it on a folder and it goes into that folder.
- Confirm Copy "…" to the server at …? with Copy.
The transfer appears below the panes under Transfers. The local file stays, this is a copy.
Download
Drag entries from Remote to Local and confirm with Download. They land in the folder the Local pane currently shows.
By right-click
Right-clicking an entry (or a selection) offers:
- in the Remote pane: Download to "…" (into the folder of the Local pane) and Delete…
- in the Local pane: Upload to "…" (into the folder of the Remote pane) and Delete…
For several entries the items read, for example, Download 3 entries to "…".
Navigate and select
- A click on a folder opens it, a click on a file opens it in the editor. The
..row at the top goes up one level. - The path bar shows the folder on one line. Click a part to jump there. With little room, the folders further up are gathered in ….
- Filter… filters the pane by name. The Case sensitive toggle makes the filter exact, and the up and down arrow keys bring back earlier filters.
- The columns Name, Size, Modified and Perms sort with a click on the header. Drag the edge to change the width, double-click to reset it. In a narrow pane WebDonkey hides columns from the right.
- Select several entries with ⌘-click or ⇧-click, ⌘A selects all, Esc clears the selection. Dragging, right-clicking and deleting then act on the whole selection.
- A link carries a small chain icon. If it points to a folder, it opens like a folder.
- The circular arrow (Refresh) reads the folder again.
The Remote pane starts in the connection's Start folder, otherwise in the home folder.
Create, rename, set permissions
- New opens a menu with File and New folder. In the dialog you enter the File name or Folder name and, optionally, Permissions (optional, e.g. 644). Create creates the entry.
- The pencil in the row (Rename) changes the name. If the name already exists in the folder, the dialog tells you.
- The lock in a row of the Remote pane (Permissions) sets the permissions as an octal number, such as
644or755. If the entry has special bits (setuid, setgid or sticky), three digits keep them, four digits set them exactly. - Upload in the header of the Remote pane picks a single file on your Mac and uploads it to the current folder.
A row's buttons appear when you hover over it.
Move
Drag entries within a pane onto a folder or onto the .. row and WebDonkey moves them after asking (Move entry, Move). If the name already exists at the target, you choose Replace (files only), Keep both (with a new name) or Skip. A folder cannot be replaced by moving.
Delete
- On the server, WebDonkey asks first. The dialog names the connection, in red as Production server for a red colour mark, and every path. A folder goes with everything in it, for good. The focus is on Cancel, so pressing Enter deletes nothing. After Delete the deletion runs in the background, and the rows show Deleting… until it is done. Whatever could not be deleted is listed afterwards in the Not deleted dialog.
- On your Mac, WebDonkey moves the entries to the Trash (Move to Trash). You can put them back from there. A link is removed as a link, what it points to stays.
WebDonkey never deletes system folders, home folders or folders above them on the server with their content.
When the target already exists
If an entry with that name already exists at the target, "…" already exists there asks:
| Button | Effect |
|---|---|
| Replace (file) | overwrites the existing file |
| Merge (folder) | copies the content into it and replaces files with the same name |
| Keep both | the copy gets a new name, which the dialog shows |
| Skip | does not transfer this entry |
Transfers
Below the file panes, Transfers lists the transfers of this tab with the amount (… of …), the file count (… of … files, before that Counting files…) and the time left (… left). The x cancels a running transfer, the folder icon (Show in Finder) opens the result in the Finder.
Move to background takes the list out of the tab. The transfers keep running, also on other pages, and then sit at the top of the window under Transfers, with Clear finished there. When they finish, the bell reports what was uploaded or downloaded.
What happens in the background
- Folders are transferred recursively.
- A replaced file on the server is written next to it first and then renamed. A running website never sees it half-written.
- The new file gets the owner, group and permissions of the old one. If the server does not allow that, WebDonkey writes into the existing file and keeps the old version at hand until the write is through.
- WebDonkey skips links, pipes, devices and files without read access and names them afterwards.
Troubleshooting
| What you see | Why | What you do |
|---|---|---|
| The folder could not be listed | The SSH user lacks read access | Connect with a user who owns the folder |
| Not deleted: this is a system folder, a home folder or a folder above one. | Protection against major damage | Pick the subfolder directly or work in the terminal |
| A name cannot be opened, renamed or deleted | The name is not valid UTF-8, often an old upload | Rename the file in the terminal |
| The connection was lost during the transfer. | Network gone or Mac asleep | Start the transfer again |
| A file does not open in the editor | It is not a text file | Transfer it instead of opening it |
See also
- Sync pairs for syncing whole folders regularly
- Editor
- Connections
- Bell and notifications
Sync pairs Premium
A sync pair links a folder or a file on your Mac with its counterpart on the server. You transfer changes with one click, up, down or both ways. You always see beforehand what will be transferred and deleted, and you can undo the last sync.
Where to find it
Sidebar Remote › SFTP / SSH, open a connection. The Sync card sits between the terminal and the file panes. The number next to the title is the number of pairs for this server.
How to do it
- Click New sync pair in the Sync card.
- Enter a Name, for example "Shop theme".
- Under Local folder or file, pick the side on your Mac with Folder… or File….
- Under Folder or file on the server, type the path or pick it with Browse… (Choose on the server, then Use this folder). A folder that does not exist yet is created on the first upload.
- Add patterns under Exclude (one pattern per line) if you need them.
- Save. The pair now shows in the card.
- Click Compare, then Sync, Upload or Download. Check the preview and start.
A file can be paired with a file of another name, for example .env.production on your Mac with .env on the server.
Fields and options
| Field | Meaning |
|---|---|
| Name | Display name of the pair. Required. |
| Local folder or file | Absolute path on your Mac. Required. |
| Folder or file on the server | Path on the server. Required. |
| Exclude (one pattern per line) | A name without / applies everywhere (node_modules, *.log), a path with / from the root folder of the pair (var/cache). Excluded items are neither transferred nor deleted. |
| In the WebDonkey Editor › Upload on save | WebDonkey Editor uploads a saved file of this pair right away. |
| In the WebDonkey Editor › Transfer deleting and renaming in the editor right away | Deleting and renaming in WebDonkey Editor take effect on the server right away. On production servers (red colour mark) nothing is ever deleted automatically, the preview always comes first there. |
The buttons of a pair
| Button | Effect |
|---|---|
| Compare | compares by size and date without reading files. Even large folders are done in seconds. Counts per status then show below the pair. |
| Open | shows the comparison file by file with Status, Local and Server: changed, only local, only on server or identical, plus newer here or newer on server. You transfer single entries with Upload this or Download this, Compare again reads anew. |
| Sync | syncs both ways with the recorded state: changes and deletions from each side, conflicts for you to decide. |
| Upload ▾ | transfers from your Mac to the server, in three ways (see below) |
| Download ▾ | transfers from the server to your Mac, in three ways |
| Pencil, bin | edit or remove the pair |
After a run, Last run … with date and result shows below the pair.
The three ways to upload and download
| Way | Effect |
|---|---|
| Sync with state (default) | New and changed files go in the chosen direction. What you deleted on the source side is deleted at the destination (on your Mac into the Trash). What exists only at the destination and was never synced stays. Conflicts are shown, never overwritten. |
| Copy only | Transfer new and changed files. Files that are newer at the destination stay unless you choose otherwise. Deletes nothing. |
| Mirror | The destination becomes an exact copy of the source. What is missing there is deleted at the destination, only after all transfers and only what the list showed you first. |
"Recorded state" means: WebDonkey remembers what was the same on both sides at the last sync. That is how it recognises deletions and changes from either side. On the first sync of a pair, identical files are only recorded as synced, and earlier deletions cannot be recognised. If the destination should become an exact copy, use Mirror (in the dialog Mirror instead…).
The preview before the start
Before every run a dialog shows what will happen:
- Transfer with count and amount per direction, a delete list with its items. Untick single deletions, Delete nothing removes them all.
- Conflicts, decide per file: this Mac, server, leave or newer, for all at once with all: this Mac, all: server or all: newer. Compare shows the differences of a file.
- With Copy only and Mirror, files that are newer at the destination are left out. If you tick Also overwrite files that are newer …, the older version replaces them. That way an old local copy does not overwrite a hotfix someone made right on the server.
- On a production server it says Production server: every change goes live right away.
The button at the bottom reads Start, Transfer and delete or Record as synced, depending on the case. If there is nothing to do, it says Everything is already in sync.
What happens in the background
- A replaced file is first written next to the target and then renamed. A running website never sees a half-written or missing file. Owner, group and permissions stay those of the replaced file.
- Before anything is replaced or deleted, WebDonkey backs up the old version (14 days). Undo last sync (…) below the pair brings back the whole run. Anything changed since then is left alone and reported.
- If a run would delete more than half of one side, WebDonkey stops and asks Delete this much?. Usually a path is wrong. Mirroring from an empty or missing source never deletes anything.
- Always protected, in both directions:
.env,.env.*(except.env.exampleand.env.dist),wp-config.phpandauth.json. That way each side keeps its own database access. Only a pair of single files transfers them. - Symlinks and special files are skipped, and their number shows after the comparison.
After the run a line shows Transferred: … · deleted: … · errors: … with the duration. Log and Errors show the details. During the run, Cancel next to the progress bar stops it.
Edit or remove a pair
Pencil and bin in the row. Remove sync pair? only removes the pair. No files are deleted, neither on your Mac nor on the server.
Troubleshooting
| What you see | What you do |
|---|---|
| Compare first. or The preview is outdated | Click Compare and start again |
| One side is a file, the other a folder | Correct the paths of the pair |
| Mirror refused | The destination is a system folder, a home folder or a folder above one. Pick the project folder itself. |
| Stopped: … more than half … | Check both paths, whether the drive is connected and whether the pair points to the right folder |
| This pair is syncing right now. | Wait a moment, another run is still active |
See also
- Files
- Editor
- Connections (red colour mark)
Editor Premium
The Editor card below the file panes opens text files from your Mac or from the server. You edit them with syntax highlighting and save them in place, without downloading and uploading them first.
Where to find it
Sidebar Remote › SFTP / SSH, open a connection. The editor is the card below Local and Remote. With no file open it says Select a file to view or edit.
How to do it
- Click a text file in Local or Remote. The editor shows it with the highlighting that fits the file extension.
- Edit the file. A yellow dot in the header and on the tab marks unsaved changes.
- Click Save. The header then shows Saved.
- The x on the right closes the file.
If you open another file while the current one has unsaved changes, Unsaved changes asks: Save, Discard or Cancel.
What the header shows
- an icon for the origin: a drive for Local, a server for Remote,
- the full path of the file,
- Latin-1 or UTF-8 with BOM when the file is encoded that way (nothing for plain UTF-8),
- the yellow dot for unsaved changes,
- Save and the x to close.
Encoding and line endings
WebDonkey saves the file in the encoding it was opened with and with its line endings (LF or CRLF). What you do not change stays the same byte for byte. If you type a character into a Latin-1 file that Latin-1 does not have, the editor names the characters and writes nothing. Remove them, and the file can be saved.
When the file changed on the server
If someone changed the file on the server after you opened it, WebDonkey does not simply save over it. The Changed on the server dialog asks:
- Overwrite replaces the version on the server with yours.
- Reload drops your changes and shows the file as it is on the server now.
- Cancel leaves both as they are. This button is preselected.
If the file was deleted or moved on the server, there is only Overwrite: it creates the file again with your version.
What happens in the background
When saving on the server, WebDonkey writes the new version next to the file and then renames it, so a running website never sees half a file. Owner, group and permissions stay as they were. If the folder does not allow that, WebDonkey writes into the file itself and puts the old content back if the write breaks off.
Limits
- The editor does not open binary files (images, archives), so it cannot damage them. Transfer them instead by dragging or right-clicking.
- Change the card's height at the grip at the bottom. If the editor is the last card of the tab (the server has no database entries), it has a grip at the top too.
- For larger projects there is WebDonkey Editor. There the sync pair controls whether a save uploads, see Sync pairs.
Troubleshooting
| What you see | What you do |
|---|---|
| "…" is not a text file. | Transfer the file instead of opening it. |
| The file could not be written on the server. | Check the permissions of the folder and the file, or connect with another user. |
| A message that the file may now be incomplete | The write broke off and the old content could not be written back. Save again once the connection is up. If a copy of the old version lies next to it, the message names it. |
See also
The server's database Premium
If a server has a database entry, its tab shows the Database card below the editor. It does the same as the Remote › Databases page: browse tables and edit rows, read the structure, run SQL, export, back up and restore. That way a server's files and database sit in one tab.
Where to find it
Sidebar Remote › SFTP / SSH, open a connection. The card is the last one in the tab, below the editor.
How the card gets into the tab
An SSH connection on its own has no database.
- Open Remote › Databases.
- Click Add database and choose this server.
- Enter the access details and save.
From then on the server's tab shows the card. Without an entry it shows neither a card nor a hint.
How to use it
- Data, Structure and SQL switch the view, as described in Browse and edit data, Structure and Run SQL.
- The header holds the kind of database, Character set, Refresh, Backup, Restore and the gear Database settings, which opens the entry for editing.
- If the server has several database entries, they show as chips above the card. A click switches the entry, and the chosen chip carries a pencil and a bin. Remove database only takes the entry out of WebDonkey, nothing is deleted on the server.
- Change the height at the grip at the bottom. As the last card of the tab it has a grip at the top too.
What happens in the background
The card works over a background connection of its own to the server, not over the terminal's session. A dump or many queries therefore do not slow down the terminal in the same tab.