Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 44. host-registration

Host Registration

Usage 

# hammer host-registration [OPTIONS] SUBCOMMAND [ARG] ...
Copy to Clipboard Toggle word wrap

Options

  • -h, --help – Print help

44.1. host-registration generate-command
Copy link

Generate global registration command

Usage 

# hammer host-registration generate-command [OPTIONS]
Copy to Clipboard Toggle word wrap

Options

  • --activation-key VALUE – Activation key for subscription-manager client, required for CentOS and Red Hat Enterprise Linux. For multiple keys use activation_keys param instead.
  • --activation-keys LIST – Activation keys for subscription-manager client, required for CentOS and Red Hat Enterprise Linux. Required only if host group has no activation keys or if you do not provide a host group.
  • --download-utility ENUM – The download utility to use during host registration Possible value(s): curl, wget
  • --force BOOLEAN – Clear any previous registration and run subscription-manager with –force.
  • --hostgroup VALUE – Hostgroup name
  • --hostgroup-id NUMBER – ID of the Host group to register the host in
  • --hostgroup-title VALUE – Hostgroup title
  • --ignore-subman-errors BOOLEAN – Ignore subscription-manager errors for subscription-manager register command
  • --insecure BOOLEAN – Enable insecure argument for the initial curl/wget
  • --jwt-expiration NUMBER – Expiration of the authorization token (in hours), 0 means unlimited.
  • --location VALUE – Set the current location context for the request
  • --location-id NUMBER – Set the current location context for the request
  • --location-title VALUE – Set the current location context for the request
  • --operatingsystem VALUE – Operating system title
  • --operatingsystem-id NUMBER – ID of the Operating System to register the host in. Operating system must have a host_init_config template assigned
  • --organization VALUE – Set the current organization context for the request
  • --organization-id NUMBER – Set the current organization context for the request
  • --organization-title VALUE – Set the current organization context for the request
  • --packages VALUE – Packages to install on the host when registered. Can be set by host_packages parameter, example: pkg1 pkg2
  • --remote-execution-interface VALUE – Identifier of the Host interface for Remote execution
  • --repo VALUE – DEPRECATED, use the repo_data param instead.
  • --repo-data SCHEMA – Array with repository URL and corresponding GPG key URL
  • --repo-gpg-key-url VALUE – DEPRECATED, use the repo_data param instead.
  • --setup-container-registry-certs BOOLEAN Use container certificates for container registry authentication. If it is set to true, container registry certificates will be installed on the host
  • --setup-insights BOOLEAN – Set host_registration_insights parameter for the host. If it is set to true, Red Hat Lightspeed client will be installed and registered on Red Hat family operating systems
  • --setup-remote-execution BOOLEAN – Set host_registration_remote_execution parameter for the host. If it is set to true, SSH keys will be installed on the host
  • --setup-remote-execution-pull BOOLEAN – Set host_registration_remote_execution_pull parameter for the host. If it is set to true, pull provider client will be deployed on the host
  • --smart-proxy VALUE – Name to search by
  • --smart-proxy-id NUMBER – ID of the Capsule. This Capsule must have enabled both the Templates and Registration features
  • --update-packages BOOLEAN – Update all packages on the host
  • -h, --help – Print help

Following parameters accept format defined by its schema (bold are required; <> contains acceptable type; [] contains acceptable value):

  • --repo-data – "repo=<string>,repo_gpg_key_url=<string>, …​ "
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat