INCUS.FILE.PUSH(1)

💖 incus-file-push — the "push files into instances" manual, bestie edition 💖

okay so real talk, this is a page from the Incus command line client man pages (that's the <italic>Incus - Command line client</italic>(1) situation, section 1, if you're keeping score), and it's all about yeeting your files into instances. let's get into it 🌸

---

✨ NAME ✨

incus-file-push — Push files into instances

like. literal main character energy. it pushes files. into instances. that's the whole vibe. 🦋

---

🎀 SYNOPSIS 🎀

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

that's the shape of it, bestie. the ... and the [:]/ are doing the heavy lifting, and then [flags] is where all your little customization dreams live 💅

---

💫 DESCRIPTION 💫

<b>Description:</b>

Push files into instances

fr fr that's it. that's the description. short, sweet, iconic. it takes files from where you are and puts them where your instance is. periodt. 👑

---

✨ OPTIONS ✨

here's where it gets juicy. every single flag, no gatekeeping, no skips 🌈

• -p, --create-dirs[=false] — makes any directories that need to exist, so you don't have to go make them yourself like some kind of peasant 🎀
• -L, --dereference[=false] — always follows symbolic links in the source path, no exceptions, no hesitation 💖
• -H, --follow[=false] — follows command-line symbolic links in the source path (yes bestie, this one is about the ones you typed on the command line specifically) 🦋
• --gid=-1 — sets the files' GIDs on push. defaults to -1, which is the "I'm not gonna touch it" energy 💀
• --mode="" — sets the file's perms on push. heads up though: in recursive mode it only sets the target directory's permissions. defaults to "" 🧚
• -P, --no-dereference[=false] — never follows symbolic links in the source path. the total opposite of -L, and yes you should pick a lane 😭
• -r, --recursive[=false] — recursively transfers files. the whole tree. the entire squad. everyone's coming 🌸
• --uid=-1 — sets the files' UIDs on push. also defaults to -1, also minding its own business ✨

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these are the flags that come down from the parent command like family heirlooms, and they still work here 💜

• --debug[=false] — show all the debug messages. every last crumb. obsessed 🔥
• --explain[=false] — if the command is valid, it explains its parsed arguments instead of running it. great for when you're like "wait what did I just type" 🙈
• --force-local[=false] — force using the local unix socket 🩵
• -h, --help[=false] — print help. the classic. the icon. the moment ⭐
• --project="" — override the source project. defaults to "" 💅
• -q, --quiet[=false] — don't show progress information. for when you want the silence 🌙
• --sub-commands[=false] — use this with help or --help to view sub-commands 👀
• -v, --verbose[=false] — show all information messages. the yapper setting 📣
• --version[=false] — print version number. simple. effective. slay ✨

---

🌸 EXAMPLE 🌸

bestie these examples are chef's kiss, look:

incus file push /etc/hosts foo/etc/hosts
   To push /etc/hosts into the instance "foo".

so like, we're taking /etc/hosts and putting it in the instance foo. that's it. that's the move. 💖

echo "Hello world" | incus file push - foo/root/test
   To read "Hello world" from standard input and write it into /root/test in instance "foo".

THE PIPE. the -. we're reading "Hello world" from standard input and writing it into /root/test inside instance foo. that's so iconic I can't even 😭🫶

---

🦋 SEE ALSO 🦋

• incus-file(1) — go read the parent one, it's the group chat this message lives in 💜

---

💀 HISTORY 💀

24-Sep-2026 — Auto generated by spf13/cobra. no cap, the robots did this one 🤖

---

and that's the whole page, bestie! 🎀 auto generated by spf13/cobra, dated Sep 2026, from the Incus - Command line client(1) manual — go push some files, you've got this 💅✨🦋