Bulwark
Docs / FeaturesUpdated MarkdownEdit on GitHub

Files

Stalwart stores files as JMAP FileNodes, and Bulwark browses them. Documents and media sit in the same interface as the mail and the calendar.

The Bulwark file browser in list view The Bulwark file browser in list view

File browser

The file browser in grid view The file browser in grid view
  • Folder tree navigation with breadcrumb path over a real FileNode hierarchy
  • Grid and list views
  • Sorting by name, size, or date
  • Starred folders and files, and recent files, in the sidebar
  • Bulk multi-select actions
  • Right-click context menu

Upload and download

  • Upload individual files with progress tracking
  • Folder upload via drag-and-drop or toolbar button (recursive)
  • Uploads go straight from the browser to the mail server's JMAP upload address, with progress and cancel. The file isn't loaded into memory first, so large uploads work, up to the server's upload limit.
  • Download files or entire selections, unless your organisation turned downloads off (device policies); files then only preview
  • Upload size limits come from the server's configuration, so Bulwark knows what's allowed before you try
  • Clipboard-style cut, copy, paste, and duplicate actions
  • Drop zone fills the available viewport height for easy bulk drops
  • Names that Stalwart 1.0 refuses are adjusted before the upload, on 0.16 as well: a reserved name such as con.txt is stored as con_.txt, control characters become _, and a name longer than 255 bytes is shortened, keeping its extension

Warning Stalwart's FileNode storage is still maturing. Very large uploads can occasionally cause server instability. Use with caution in production deployments.

Preview

A PDF opened in the preview A PDF opened in the preview
  • Images (JPEG, PNG, WebP, GIF, SVG, AVIF and more)
  • Text and source code (plain text)
  • Markdown
  • HTML, in a sandboxed frame
  • Saved emails (.eml)
  • Audio
  • Video
  • PDF (the browser's viewer on desktop, a built-in viewer on phones)

Office documents

Word-processor, spreadsheet and presentation files open for editing in place when a WOPI-capable office server is configured. Collabora Online, OnlyOffice and EuroOffice are the ones the integration was written against. Set WOPI_CLIENT_URL to the editor's base URL (Bulwark fetches its discovery document from <url>/hosting/discovery) and, if the editor reaches the webmail on a different hostname than the browser does, WOPI_HOST_URL to the address it should use. Leave WOPI_CLIENT_URL empty and the feature is off. You can set the same values in the admin console under Server > Document editing; a value saved there overrides the environment variable. The editor has to allow this webmail as a WOPI host. New file formats and Template directory (WOPI_NEW_FILE_FORMATS, WOPI_TEMPLATE_DIR) control what New file offers. The demo fixtures include office documents so you can see the integration without uploading anything.

A spreadsheet from Files open for editing in the office editor inside Bulwark A spreadsheet from Files open for editing in the office editor inside Bulwark
Not in Lite. Office editing relies on the Node.js server to broker the WOPI session, so the edit action is hidden and documents download instead.

Sharing

Files and folders can be shared with other users or groups on the server (JMAP sharing, RFC 9670). Pick the person or group, grant Read only, Read & write or Manager (an administrator can limit this to read only), and the item shows a shared indicator. Anything shared with you appears under Shared with me.

On Stalwart 1.0, picking a principal from the server's directory needs directory queries, which are off by default. An administrator turns them on with Allow Directory Queries under Settings > Files & Sharing > Sharing; without them the list only offers your groups and the people who have shared something with you.

Organization

  • Create, rename, move, and delete folders
  • Deleted files and folders go to the trash, where you can restore them or delete them for good. Empty the trash to free the space.
  • Files are stored as real FileNode records in a nested hierarchy and listed via FileNode/get; each node's nodeType tells files, folders and links apart
  • Symbolic links, which Stalwart 1.0 can store, show as links: they can be renamed, moved and deleted, but not opened or downloaded
  • Files that legacy installs stored under flat, slash-encoded names are moved into folders automatically on first load
  • Each file shows its size and modified date
  • Recent files prune themselves automatically when underlying nodes are deleted on the server

Integration

  • Files use the same sign-in and permissions as the rest of Bulwark
  • With several accounts connected, each account's files stay separate
  • Attachments and stored files are one click apart

Next step

To get mail, calendar, contacts and files on a phone, see Mobile apps and push.