How to Open Remote Server Files in the iOS Files App
Editing a file on a server from an iPhone usually means one of two compromises: work inside a terminal editor like vim, or download the file, edit it locally, and upload it back — remembering to re-upload every time. Neither lets you open a remote file in a real iOS app. There is a third option built into iOS: a File Provider, which registers a server folder as a location in the Files app so any app can open, edit, and save to it directly over SFTP. Here's how it works and how to set it up with GateShell on iPhone and iPad.
Step by step
- 1
Understand what a Files app location actually is
iOS lets apps register as File Providers, which is the same mechanism iCloud Drive, Dropbox, and Google Drive use to appear under Browse in the Files app. A registered location isn't a copy of your server — there is no sync folder filling up your device. When an app opens a file from that location, iOS asks the provider for it, GateShell fetches it over SFTP on demand, and saving pushes it straight back to the server. Nothing is stored on an intermediary service.
- 2
Add the server to GateShell and connect once
Save the server in GateShell with its host, port, username, and either a password or an SSH key, then connect once to confirm the credentials work and to accept the host key. The Files integration reuses the same saved credentials and the same trust-on-first-use host-key pin as your terminal sessions, so a server that connects normally will work here too.
- 3
Choose which folder to expose — not the whole server
Open the server's settings, scroll to the Advanced section, and tap "Add Folder to Files". GateShell browses the server so you can navigate to the directory you want and tap "Use This Folder"; if the server is unreachable right now you can type an absolute path instead. Exposing a specific folder such as /var/www or /home/deploy is deliberate: only that subtree becomes reachable from the Files app, not the entire filesystem. Add several folders if you want, and each one appears as its own location.
- 4
Open the location in the Files app
Launch the Files app and tap Browse. Your folder appears under Locations, named after the server and folder. Tap in and you'll see the remote directory listing. If a location doesn't appear, pull to refresh the Browse list, or check the Locations list via the ellipsis menu — iOS occasionally needs a moment to register a newly added provider.
- 5
Edit remote files from any app
From that point on the folder behaves like any other Files location. Open a config file in a text editor, attach a remote log to an email, save a document from Pages straight to the server, or drag files between your server and iCloud Drive. Creating folders, renaming, and deleting all work too, subject to the file's own permissions on the server — a directory your user can't write to stays read-only.
- 6
Remove a folder when you're done
Return to the server's Advanced settings and tap the remove control next to a folder. Its location disappears from the Files app immediately. Removing a folder never deletes anything on the server; it only withdraws the Files app's access to it.
Frequently asked questions
Does this download my whole server to my iPhone?+
No. Nothing is downloaded until an app actually opens a file, and only that file is fetched. There is no sync folder and no background mirroring, so exposing a large directory costs no storage on the device.
Can I limit Files app access to one folder instead of the whole server?+
Yes — that is the intended way to use it. You pick the folder when you add it, and only that folder and its contents are reachable from the Files app. Paths outside it are rejected even if something on the device previously cached a reference to them. Add multiple folders if you need several entry points; each becomes its own location.
Does the Files app integration work on Mac?+
Not currently. GateShell's File Provider is built for iOS, so folder locations appear in the Files app on iPhone and iPad. On Mac, use GateShell's built-in SFTP browser to transfer files.
Is this SFTP or SMB?+
SFTP, over the same SSH connection GateShell already uses for the terminal. That means it works anywhere SSH works, with no extra service to expose on the server and no second set of credentials. If you happen to run Samba, GateShell can also manage that service from its Samba dashboard — but the Files integration itself needs nothing installed beyond SSH.
Do my credentials leave the device?+
No. The Files integration reads the same credentials from the Apple Keychain that the terminal uses, and connects directly to your server. There is no relay, no proxy, and no vendor cloud in the path.
Why does my location say "Authentication Required"?+
iOS shows that when the provider can't verify the connection. Open GateShell, confirm the server still connects normally, and check that the folder is still listed under the server's Advanced settings. Re-adding the folder re-registers the location.
Try it in GateShell
GateShell is a zero-backend SSH client for iPhone, iPad, and Mac — no vendor cloud, no accounts, no telemetry. Everything above works out of the box.
Guide reflects GateShell's shipped features as of August 2026. Steps assume basic familiarity with SSH and the command line; server-side commands may vary by distribution. All product names, logos, and brands are property of their respective owners.