FLATPAK-DOCUMENT-EXPORT(1)

💅 flatpak-document-export — bestie edition

okay so this is the manual page for flatpak-document-export from the flatpak command family — she lives in section 1 of the man pages, and honestly? she's kind of a baddie. let's get into it ✨

---

🎀 NAME 🎀

flatpak-document-export — export a file to a sandboxed application 🫶

---

✨ SYNOPSIS ✨

flatpak document-export [OPTION...] FILE

one file, a whole pile of options if you want them. that's the whole vibe. 💅

---

🌸 DESCRIPTION 🌸

So what she does is: she creates a document id for a local file, and that id can be exposed to sandboxed applications. Translation? It lets those apps see files they would NOT otherwise see. no cap. the exported files get exposed in a fuse filesystem at:

/run/user/$UID/doc/

👑 iconic behavior honestly.

And she's not just a one-trick pony — this command also lets you modify the per-application permissions of the documents. so you can grant or revoke access to the file, on a per-application basis. like a little permission bouncer at the door. 🚪✨

---

💖 OPTIONS 💖

The following options are understood:

• -h, --help — shows you the help options and dips. that's it, that's the whole job. 🙈
• -u, --unique — don't reuse an existing document id for the file. this is the one you want if you're planning to remove the document later once you're done with it, because it's safe to do that. 🫶
• -t, --transient — the document will only exist for the length of the session. perfect for temporary grants, like a lil pop-up shop but for permissions. 🦋
• -n, --noexist — don't require the file to exist already. she's flexible like that. 💅
• -a, --app=APPID — grant read access to the specified application. the --allow and --forbid options can be used to grant or remove additional privileges. and yes bestie, this option can be used multiple times — stack her up. 🔥
• -r, --allow-read — grant read access to the applications specified with --app. this defaults to TRUE. ⭐
• --forbid-read — revoke read access for the applications specified with --app. bye bye read privileges 💀
• -w, --allow-write — grant write access to the applications specified with --app. ✍️
• --forbid-write — revoke write access for the applications specified with --app. ✍️🚫
• -d, --allow-delete — grant the ability to remove the document from the document portal to the applications specified with --app. 🗑️✨
• --forbid-delete — revoke the ability to remove the document from the document portal from the applications specified with --app. no deleting for you 🗑️🚫
• -g, --allow-grant-permission — grant the ability to grant further permissions to the applications specified with --app. permission to give permission, very meta, very main character. 👑
• --forbid-grant-permission — revoke the ability to grant further permissions for the applications specified with --app. 🚫
• -v, --verbose — print debug information during command processing. the tea ☕
• --ostree-verbose — print OSTree debug information during command processing. extra tea, specifically ostree-flavored 🧚

---

🌈 EXAMPLES 🌈

look at her go:

$ flatpak document-export --app=org.gnome.gedit ~/test.txt

and she gives you back:

/run/user/1000/doc/e52f9c6a/test.txt

ate. no crumbs. 🍓

---

👑 SEE ALSO 👑

flatpak(1), flatpak-document-unexport(1), flatpak-document-info(1), flatpak-documents(1)

---

and that's the whole page bestie, go export some documents, you're literally built for this 💜

this one came from the flatpak source, section 1 of the manuals, dated like all the other flatpak pages — mwah, love her, bye 🎀🦋✨