Managing Heaps

Heaps are your top-level workspace/vault in Heaper. Each heap is an independent collection of blocks with its own tags, files, and settings.

Creating a Heap

1. Open Settings → Heaps
2. Click Create local Heap
3. change the name of the heap by clicking on the title in the top left corner of the heap, or swiping down the bottom sheet to reveal the text editor. 4. Open Settings → Heaps
4. Optionally, under sync add syncing to either the Heaper cloud or your own self-hosted server.

When you create a heap, Heaper automatically creates an index block that serves as the root of the heap.

Local vs. Cloud-Synced

• Local-only — Data stays on your device. No server connection needed but no syncing.
• Cloud-synced — Syncs to heaper.de or your self-hosted server. Available across all your devices.

Pulling a Heap from a Server

To access a heap from another server (e.g. your self-hosted instance):

1. Go to Settings → Heaps → Pull Heap 1.1 Select I have my own server or the Heaper cloud. Here you would need to either authenticate with your email address for the online version or with a public and private key which you do via your seed phrase for decentral self hosted authentication. see authentication for more information.
2. Enter the server address
3. Heaper downloads the metadata and tiny thumbnails first, then syncs larger thumbnails in the background

A First Sync Overlay shows progress during the initial download.

Renaming a Heap

You can rename a heap by sliding down the bottom sheet as the title is derived from the title on its rich text document. The heap as everything in Heaper is just a block.

Deleting a Heap

Local heaps.

1. Open Settings → Heaps
2. Select the heap you want to remove
3. Click Delete at the bottom in the danger zone. Deleting a heap removes it from your local device. If the heap is cloud-synced, the server data is preserved — you can pull it again later if needed.

Note: Deleting a heap here is a local operation. Other users who have pulled the same heap are not affected. Just removes it from your device.

Cloud heaps.

1. Open Settings → Servers
2. Select the heap you want to remove
3. Click Delete It permanently deletes the heap from the server and is no longer able to be pulled again.