Skip to content

How to sync using SMB network drive ​

This guide explains how to sync KeePassium database with other devices using SMB network drive (network share).

Integration with iOS Files app ​

  • Add your network drive (SMB server) to the Files app
    • Open the standard iOS Files app
    • Tap Browse → More → Connect to Server
    • Enter the server address and credentials, then tap Next
  • Open KeePassium, go to Databases screen
  • Tap More → Open Database
  • Navigate to your database and select it

Troubleshooting ​

Read-only file system (iOS 18) ​

There are multiple reports that SMB folders become read-only after updating to iOS 18. A possible workaround is published on Apple Support Forums: How to resolve SMB server read-only access on iPhone?

Server unreachable ​

When your SMB server is unreachable from device, KeePassium will do its best to show the last-seen local copy of database. However, many file operations may become unresponsive — this is a long-standing system issue. The quickest workaround is to restart the device.

Empty file ​

Sometimes the system's SMB implementation fails to download the database completely. In this cases, KeePassium shows that database is either empty or ended unexpectedly. As a workaround, try to re-add the database to the app.

See also ​