SUSECONNECT(8)

💅 SUSECONNECT — like, the SUSEConnect manual page, bestie (section 8, SUSECONNECT(8) energy) 🎀

okay so listen. this is the whole vibe of SUSEConnect, the SUSE Customer Center registration tool. everything's here, nothing's missing, pinky promise 🫶

---

✨ NAME ✨

SUSEConnect — the SUSE Customer Center registration tool, aka the little guy that gets your machine officially on the internet with SUSE 💖

---

🌸 SYNOPSIS 🌸

SUSEConnect [<optional>...]  -p PRODUCT

that's it. that's the shape of it. iconic.

---

🦋 DESCRIPTION 🦋

So basically: SUSEConnect registers your SUSE Linux Enterprise installations with the SUSE Customer Center. Why do we care? Because registering is literally what unlocks access to software repositories (updates included, bestie, updates included) and it lets you manage your subscriptions and organizations online. main character access only 🔥

By default, SUSEConnect registers the base SUSE Linux Enterprise product installed on your system. But it can also register extensions and modules — yes, more ✨

Wanna register an extension or a module? Use the --product <PRODUCT-IDENTIFIER> option together with the product identifier of that extension or module. And if you wanna peek at everything available? Hit --list-extensions and see the full menu of extensions and modules for your system. iykyk 💅

Manage your subscriptions at the SUSE Customer Center: https://scc.suse.com — go, be responsible, slay 👑

---

🌈 OPTIONS 🌈

okay this is the big one. every single flag, no skips, no cap:

• -p, --product <PRODUCT> — picks which product to activate/deactivate. Only one product at a time, so don't get greedy 🙈. Defaults to the base SUSE Linux Enterprise product on this system. You get product identifiers from --list-extensions. Format: <name>/<version>/<architecture>
• -r, --regcode <REGCODE> — the subscription registration code for the product you're registering. It ties that product to the specified subscription and turns on software repositories for it. Cute bonus: -r - passes the registration code via stdin, and -r @/file/path points at a file containing the code. versatile icon 💅
• -d, --de-register — de-registers the system and base product, or (with --product) just a single extension, and removes all its services installed by SUSEConnect. after this the system no longer consumes a subscription slot in SCC. bye bestie 🫶
• -l, --list-extensions — lists all extensions and modules available for installation on this system. window shopping ✨
• --instance-data <path to file> — path to the XML file holding the public key and instance data for cloud registration with SMT
• -e, --email <email> — email address for product registration
• --url <URL> — URL of the registration server (e.g. https://scc.suse.com)
• --namespace <NAMESPACE> — namespace option for use with SMT staging environments
• -s, --status — gets current system registration status in json format
• --status-text — gets current system registration status in text format
• --keepalive — sends a keepalive call to the registration server so it can detect which systems are still running. "i'm alive" but make it protocol 💀
• --write-config — writes options to the config file at /etc/SUSEConnect
• --cleanup — removes old system credentials and all zypper services installed by SUSEConnect. spring cleaning 🌸
• --rollback — reverts the registration state in case of a failed migration
• --root <PATH> — path to the root folder, uses the same parameter for zypper
• --gpg-auto-import-keys — automatically trust and import new repository signing keys
• --version — prints program version
• --debug — provides debug output
• --json — prints output in JSON format. ⚠️ this flag is only supported for registering, de-registering and list-extensions — so don't try it on everything, it will not serve 💀
• -h, --help — shows help message

---

🎀 EXIT CODES 🎀

SUSEConnect sets these exit codes, and yes we're listing all of them:

• 0: Registration successful 🎉
• 64: Connection refused
• 65: Access error, e.g. files not readable
• 66: Parser error: Server JSON response was not parseable
• 67: Server responded with error: see log output

---

💜 COMPARED TO SUSE_REGISTER 💜

⭐ BEFORE

suse_register -a email=<email> -a regcode-sles=<regcode> -L <logfile>

⭐ AFTER

SUSEConnect --url <registration-server-url> -r <regcode> >> <logfile>

glow-up complete, honestly ✨

---

🧚 USE WITH REGISTRATION PROXY 🧚

SUSEConnect can also be used to register systems with a local SUSE registration proxy (RMT/SMT) instead of the SUSE Customer Center. Just use SUSEConnect --url <registration-proxy-server-url> to register systems with RMT/SMT. local legend behaviour 💅

---

👑 IMPLEMENTATION 👑

SUSEConnect is implemented in Golang. It talks to the registration server using a RESTful JSON API over HTTP, wrapped in TLS encryption. secure, modern, doing the most (affectionate) 🔥

---

🌟 ENVIRONMENT 🌟

SUSEConnect respects the HTTP_PROXY environment variable. See https://www.suse.com/support/kb/doc/?id=000017441 for more details on how to manually configure proxy usage. proxy bestie, we got you 🫶

---

🍓 FILES 🍓

• /etc/SUSEConnect — configuration file containing server URL, regcode and language for registration

---

💖 AUTHOR 💖

SUSE LLC (<scc-feedback@suse.de>)

---

🔗 LINKS 🔗

SUSE Customer Center: https://scc.suse.com

SUSEConnect on GitHub: https://github.com/SUSE/connect-ng

---

💀 SEE ALSO 💀

SUSEConnect(5)

---

this page was cooked up in January 2022, and it's page SUSECONNECT(8) of the manual, in case you were wondering. now go register something, you gorgeous nerd 🧚✨💅