Navigation

Auxiliary Files

Overview

MongoDB Realm stores data on the filesystem in auxiliary files. You can access these files through the Realm SDK. In some error situations detailed below, you might need to manually delete the auxiliary files. Otherwise, these are implementation details that you can safely ignore, presented here only for the curious.

Auxiliary File Types

MongoDB Realm’s internal operation depends on several auxiliary file types:

<path>.realm:
The realm file contains the data and metadata of the realm at the given Realm path. Each app can have several realms at different paths, each with their own realm file.
<name>.realm.lock:
The lock file enables synchronization between writes.
<name>.realm.note:
The note file is a named pipe for inter-thread and inter-process notifications. While usually completely internal, the note file can cause the “unsupported resource found” error in iOS builds if you accidentally add it to the app bundle. If you see this error, delete the pipe.
<name>.realm.management:
The management directory contains internal files for the realm’s state management.

Manually Deleting Auxiliary Files

In some circumstances, you might need to delete the auxiliary files. You may delete auxiliary files when the realm is closed. Deleting any of a realm’s files while the realm is open might corrupt the realm or disrupt Sync.

Realm Studio

Realm Studio is a developer tool for desktop operating systems that allows you to manage Realm Database instances. With Realm Studio, you can open and edit local and synced realms. It supports Mac, Windows, and Linux.

A screenshot of Realm Studio

See Releases on GitHub: