LXC.FILE.PUSH(1)

💅 lxc-file-push — the LXD command line client, bestie edition

okay so first things first, the manual name up top is LXD - Command line client(1) — that's the whole vibe of the family this page belongs to. and this specific page? this is lxc file push, the "put my stuff inside the container" command. no cap.

✨ NAME ✨

lxc-file-push — push files into instances 🫶

🦋 SYNOPSIS 🦋

lxc file push ... [:]/ [flags]

that's the whole shape of it. there's ... in there (very mysterious, very "you know what it is"), then a [:]/ situation, then your [flags]. she's giving flexible. 💅

🌸 DESCRIPTION 🌸

so like, the actual description, straight up:

Push files into instances.

that's it. that's the whole thing. you have files, you have an instance, and this is the bridge between them. iconic behavior honestly. ✨

🎀 OPTIONS 🎀

these are her options, the ones that belong to lxc file push specifically:

• -p, --create-dirs[=false] — makes any directories that need to exist, y'know, exist. like if the path you're pushing to has folders that aren't there yet, this handles it. defaults to false, so by default she will not be doing that for you. 🙈
• --gid=-1 — sets the file's gid on push. default is -1.
• --mode="" — sets the file's perms on push. default is empty (""), i.e. not set.
• -r, --recursive[=false] — recursively transfer files. whole folders, all the way down. default is false ⭐
• --uid=-1 — sets the file's uid on push. default is -1.

quick heads up bestie: a couple of these come with some stray `` backtick bits in the original text. that's just a formatting artifact, not a secret extra flag. moving on 💀

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these aren't hers, she got them from her parent commands. family traits, iykyk:

• --debug[=false] — show all debug messages. default false.
• --force-local[=false] — force using the local unix socket. default false.
• -h, --help[=false] — print help. default false (obvi).
• --project="" — override the source project. default is empty.
• -q, --quiet[=false] — don't show progress information. default false.
• --sub-commands[=false] — use this with help or --help to view sub-commands. default false.
• -v, --verbose[=false] — show all information messages. default false.
• --version[=false] — print version number. default false.

🔥 EXAMPLE 🔥

this is the one that makes it click, fr fr:

lxc file push /etc/hosts foo/etc/hosts

what's happening here? you're pushing /etc/hosts into the instance called "foo". so /etc/hosts from your machine lands at /etc/hosts inside foo. slay. ⭐

🧚 SEE ALSO 🧚

• lxc-file(1) — go read that one too, she's the whole file subcommand situation 💜

🌈 HISTORY 🌈

22-Aug-2026 — Auto generated by spf13/cobra.

not me being literally autogenerated 😭 at least the cobra did a good job.

---

and that's the page!! 🎀 little sign-off as promised: this whole thing is Auto generated by spf13/cobra, dated Aug 2026, and it lives under the banner of LXD - Command line client(1). go push some files, bestie, you got this 💖✨