INCUS.COPY(1)

💅 incus-copy — bestie, we're copying instances

okay so this one lives in the Incus - Command line client(1) manual, and it's literally the page for incus copy — the "move my stuff from here to there (or from there to there)" command. Copying instances within a server, or in between servers. Both. Iconic.

---

✨ SYNOPSIS ✨

incus copy [:][/] [:][] [flags]

no cap, that's the exact synopsis as printed, brackets and all 💀 it's giving mysterious on purpose

---

🦋 DESCRIPTION 🦋

Description: copy instances within or in between servers. Two servers. One server. Wherever, honestly. Slay.

Now, the ✨transfer modes✨ (this is the --mode thing, and it matters, so pay attention bestie):

• pull — the target server pulls the data from the source server. the source has to be listening on the network for this to work.
• push — the source server pushes the data to the target server. now the target is the one that has to be listening on the network.
• relay — the CLI connects to both the source and the server and proxies the data itself. for this vibe, both source and target must be listening on the network.

and the headline: pull is the default transfer mode, because it's compatible with all server versions. retro-compatible queen 👑

---

🎀 OPTIONS 🎀

• --allow-inconsistent[=false] — ignore copy errors for volatile files. yes, ignore them. we're being chill about it.
• -c, --config=[] — config key/value to apply to the new instance
• -d, --device=[] — new key/value to apply to a specific device
• -e, --ephemeral[=false] — ephemeral instance (it exists, it vanishes, main character exit)
• --instance-only[=false] — copy the instance without its snapshots. no little baby snapshots tagging along.
• --mode="pull" — transfer mode. one of pull, push or relay
• --no-profiles[=false] — create the instance with no profiles applied. naked. profile-less. free.
• -p, --profile=[] — profile to apply to the new instance
• --refresh[=false] — perform an incremental copy
• --refresh-exclude-older[=false] — during an incremental copy, exclude source snapshots earlier than the latest target snapshot
• --stateless[=false] — copy a stateful instance stateless
• -s, --storage="" — storage pool name
• --target="" — cluster member name
• --target-project="" — copy to a project different from the source 👀 moving it to a whole other project, we love a glow-up

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these come from the parent command, they're not copy-specific, but they're here and they're valid:

• --debug[=false] — show all debug messages
• --explain[=false] — if the command is valid, explain its parsed arguments instead of running it. it just tells you what it would do. queen of consent.
• --force-local[=false] — force using the local unix socket
• -h, --help[=false] — print help
• --project="" — override the source project
• -q, --quiet[=false] — don't show progress information
• --sub-commands[=false] — use with help or --help to view sub-commands
• -v, --verbose[=false] — show all information messages
• --version[=false] — print version number

---

👑 SEE ALSO 👑

• incus(1)

go read that one too, it's the mothership 🫶

---

📜 HISTORY 📜

• 24-Sep-2026 — Auto generated by spf13/cobra

---

that's the whole page babes, every flag accounted for, nothing skipped, no cap 💖

and for the sign-off credits: this page is Auto generated by spf13/cobra, dated Sep 2026, from the Incus - Command line client(1) manual. periodt. ✨🎀🦋