INCUS.REMOTE.ADD(1)

📦
version 7.0.1 · 11 versions
, in ubuntu stonking

💖 incus-remote-add(1) — the "add a new remote server" page 💖

okay bestie so this is a page from the Incus - Command line client(1) manual — yes that's the manual name, it's giving very official, very main character 👑

✨ NAME ✨

incus-remote-add — literally just add new remote servers, that's it, that's the whole vibe

🦋 SYNOPSIS 🦋

incus remote add ⟨IP/FQDN/URL>...|<token⟩ [flags]

🌸 DESCRIPTION 🌸

Description:

Add new remote servers 💅

So the URL for remote resources must be HTTPS — like https:// or nothing, no exceptions, the vibe check is strict 🔒

You can also do basic authentication, but only when you pair it with the simplestreams protocol:

incus remote add some-name
https://LOGIN:PASSWORD@example.com/some/path --protocol=simplestreams

And here's the iconic part — you can hand it several remote targets at once, so if one server is down it just switches to another one, no drama, no meltdown:

incus remote add some-name server1.example.com server2.example.com

Also, if you're only giving it a single target, you can straight up ignore the remote name. no name needed, it's fine, she's independent 🙈

🎀 OPTIONS 🎀

  • --accept-certificate[=false] — accept certificate. yes girl just say yes to the certificate 💖
  • --auth-type="" — the server authentication type (either tls or oidc)
  • --credentials-helper="" — a binary helper for retrieving credentials
  • --keepalive=0 — keep the remote connection alive so commands come back faster ⚡
  • --project="" — which project to use for the remote
  • --protocol="incus" — the server protocol (your choices are incus, oci or simplestreams)
  • --public[=false] — public image server
  • --token="" — the remote trust token, keep it secret keep it safe 🤫

💜 OPTIONS INHERITED FROM PARENT COMMANDS 💜

these ones come from the parent command, she got them from her mom, periodt

  • --debug[=false] — show ALL the debug messages, every last one
  • --explain[=false] — if the command is valid, it explains its parsed arguments instead of actually running it
  • --force-local[=false] — force using the local unix socket
  • -h, --help[=false] — print help
  • -q, --quiet[=false] — don't show progress information, we're being chill about it
  • --sub-commands[=false] — use this with help or --help to view sub-commands
  • -v, --verbose[=false] — show all information messages
  • --version[=false] — print the version number

🌈 SEE ALSO 🌈

  • incus-remote(1) — go read her sister page, iykyk

⭐ HISTORY ⭐

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

just so we're clear bestie: this whole page was Auto generated by spf13/cobra, and the version/date on the tin is Sep 2026. slay ✨

and that's the page!! no cap, you're now officially certified in incus-remote-add 💅👑🫶

📦 where this page comes from