![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/important-icon.png\"){kind=icon}
<\/p><\/div>
When installing the JumpCloud Agent, the Device Name (Display Name) is automatically mapped to the configured macOS Computer Name. While these attributes can be updated on the macOS devices after agent install, the Device Name (Display Name) in JumpCloud does not update automatically. The ‘Hostname’ value in JumpCloud will update to reflect local device changes.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Hostname types in macOS:<\/p>\n\n\n\n
- \n
- LocalHostName: <\/strong>This name will reflect the Local Bonjour Computer Name with ‘.local’ appended to the Hostname. These can be set differently so review carefully. This is the name that gets set during the initialization of your macOS device on the first time set up of the device.<\/li>\n\n\n\n
- ComputerName: <\/strong>This name will map to the \u201cHostname\u201d reference within the JumpCloud Admin Portal. Generally this name is the same as the LocalHostName upon the first time set up of your macOS device.<\/li>\n\n\n\n
- HostName: <\/strong>The underlying MacOS System via the Terminal also has a ‘Hostname’ reference that can be set as well as a local ‘hosts’ file to override DNS, which is outside the scope of this article.<\/li>\n<\/ul>\n\n\n\n
Changing the macOS Local Hostname Manually<\/h3>\n\n\n\n
To change the hostname on macOS 12 Monterey and prior:<\/p>\n\n\n\n
- \n
- Go to System Preferences<\/strong> > Sharing<\/strong>.<\/li>\n\n\n\n
- Click Edit<\/strong> to update the Computer Name.
![\"macOS](\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/11\/macos_systempref_sharing_settings.png\")
<\/li>\n\n\n\n- Enter the desired name and click OK<\/strong>.
![\"Sharing](\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/11\/macos_systempref_sharing_settings2_snagit.jpg\")
<\/li>\n<\/ol>\n\n\n\nTo change the hostname on macOS Ventura 13 and newer:<\/p>\n\n\n\n
- \n
- Go to System Settings<\/strong> > General<\/strong> > Sharing<\/strong>.<\/li>\n\n\n\n
- Click Edit <\/strong>to update the Local hostname.<\/li>\n\n\n\n
- Enter the desired name and click OK<\/strong>.
![\"Message](\"https:\/\/jumpcloud.com\/\/wp-content\/uploads\/2023\/11\/macos_systemsettings_ventura_sharing_settings.png\")
<\/li>\n<\/ol>\n\n\n\nAllow up to 30 minutes for the JumpCloud Agent to update the device\u2019s information to the newly changed hostname.<\/p>\n\n\n\n
To verify the device’s hostname in JumpCloud<\/strong>:<\/p>\n\n\n\n
- \n
- Log in to the JumpCloud Admin Portal.<\/a><\/li>\n\n\n\n
- Go to DEVICE MANAGEMENT<\/strong> > Devices<\/strong>.<\/li>\n\n\n\n
- Select the Devices<\/strong> tab.<\/li>\n\n\n\n
- Locate the device in the list and select it.<\/li>\n\n\n\n
- Go to the Insights<\/strong> tab and scroll down to Network<\/strong> to view the Hostname<\/strong>.<\/li>\n<\/ol>\n\n\n\n
Next, update the JumpCloud Device Name<\/strong> based on the updated macOS hostname. See Using PowerShell to Update the Device Name<\/a> to reflect the new Hostname.<\/p>\n\n\n\n
<\/p><\/div>Important:<\/strong> \nThere are only two methods to update the JumpCloud Device Name: either manually via the API, or via the JumpCloud PowerShell Module. See the following section for instructions using the PowerShell Module.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Using Commands to Change the Local Hostname<\/h3>\n\n\n\n
You can also update the device’s local hostname using JumpCloud Commands from the Commands and standard macOS command-line utilities. For more information on commands, see Get Started: Commands<\/a>.<\/p>\n\n\n\n
To create a new Command within JumpCloud for macOS<\/strong>:<\/p>\n\n\n\n
- \n
- Log in to the JumpCloud Admin Portal.<\/a><\/li>\n\n\n\n
- Go to DEVICE MANAGEMENT<\/strong> > Commands<\/strong>.<\/li>\n\n\n\n
- Click ( +<\/strong> ), then choose Command<\/strong>.<\/li>\n\n\n\n
- Name the command (for example, Rename Hostname for macOS).<\/li>\n\n\n\n
- Using the following command as a template, enter the new name of the device where it says NEW_HOSTNAME_GOES_HERE <\/strong>and enter in the Command<\/strong> box.<\/li>\n\n\n\n
- Name the command. (e.g. Rename Hostname for macOS)<\/em><\/li>\n\n\n\n
- Edit the following command and enter the new name of the device where it says NEW_HOSTNAME_GOES_HERE.<\/li>\n<\/ol>\n\n\n\n
\n
#Change Hostname
sudo scutil –set HostName NEW_HOSTNAME_FQDN_GOES_HERE
#Change LocalName
sudo scutil –set LocalHostName NEW_HOSTNAME_GOES_HERE
#Change ComputerName
sudo scutil –set ComputerName NEW_HOSTNAME_GOES_HERE
#Flush DNS Cache
dscacheutil -flushcache<\/p>\n<\/div><\/div>\n\n\n\n- \n
- Save<\/strong> and then bind this Command to the device you want to update via the Devices<\/strong> tab.<\/li>\n<\/ol>\n\n\n\n<\/p><\/div>Important:<\/strong> \n
Please ensure you are only binding this command to one <\/strong>device at a time.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
- \n
- Once you\u2019ve bound the Command to the Device, Run the command and wait for a result code of 0 (Success).<\/li>\n\n\n\n
- Upon successful execution of the command, it is highly recommended to restart the device.<\/li>\n<\/ol>\n\n\n\n
Next, update the JumpCloud Device Name <\/strong>based on the updated macOS hostname. See Using PowerShell to Update the Device Name<\/a> to reflect the new Hostname.<\/p>\n\n\n\n
Using PowerShell to Update the Device Name to Reflect the Hostname<\/h2>\n\n\n\n
Use the following JumpCloud PowerShell command to update the JumpCloud Device Name to match macOS device\u2019s hostname.<\/p>\n\n\n\n
- Go to DEVICE MANAGEMENT<\/strong> > Commands<\/strong>.<\/li>\n\n\n\n
- Go to DEVICE MANAGEMENT<\/strong> > Devices<\/strong>.<\/li>\n\n\n\n
- Click Edit <\/strong>to update the Local hostname.<\/li>\n\n\n\n
- Click Edit<\/strong> to update the Computer Name.
- ComputerName: <\/strong>This name will map to the \u201cHostname\u201d reference within the JumpCloud Admin Portal. Generally this name is the same as the LocalHostName upon the first time set up of your macOS device.<\/li>\n\n\n\n