<h2>Edit File: ensure_hostname_resolves</h2><form method="post"><textarea name="content" rows="20" cols="80">#!/usr/local/cpanel/3rdparty/bin/perl

#                                      Copyright 2025 WebPros International, LLC
#                                                           All rights reserved.
# copyright@cpanel.net                                         http://cpanel.net
# This code is subject to the cPanel license. Unauthorized copying is prohibited.

package scripts::ensure_hostname_resolves;

=encoding utf8

=head1 NAME

ensure_hostname_resolves

=head1 DESCRIPTION

Utility that checks to ensure that the hostname resolves to the server.

It can also update the hostname to use an &#039;autodomain&#039; hostname which is guaranteed to resolve.

=head1 SYNOPSIS

    ensure_hostname_resolves [OPTIONS]

    --yes           Skip the prompts, and assume &#039;yes&#039;

    --help          This documentation.

=cut

use cPstrict;

use Try::Tiny;

use IO::Prompt                       ();
use Cpanel::Exception                ();
use Cpanel::Hostname                 ();
use Cpanel::IP::Loopback             ();
use Whostmgr::Hostname               ();
use Cpanel::Domain::ExternalResolver ();

use constant _OPTIONS =&gt; (&#039;yes&#039;);

use parent qw( Cpanel::HelpfulScript );

exit __PACKAGE__-&gt;new(@ARGV)-&gt;run() unless caller();

sub run ($self) {
    die Cpanel::Exception::create(&#039;RootRequired&#039;)-&gt;to_string_no_id() unless ( $&gt; == 0 &amp;&amp; $&lt; == 0 );

    my $hostname_resolves_local;

    try {
        if ( $hostname_resolves_local = $self-&gt;hostname_resolves() ) {
            print &quot;[+] Hostname resolves to the server.\n&quot;;
        }
        else {
            print &quot;[!] Hostname does NOT resolve to the server.\n&quot;;
        }
    }
    catch {
        my $str = Cpanel::Exception::get_string($_);
        print &quot;[!] Failed to determine if hostname resolves to the server: $str\n&quot;;
    };

    return 0 if $hostname_resolves_local;

    if ( $self-&gt;getopt(&#039;yes&#039;) || $self-&gt;prompt_yn() ) {
        print &quot;[*] Configuring auto-resolving hostname...\n&quot;;
        my $new_hostname = Whostmgr::Hostname::set_autodomain_hostname();
        print &quot;[+] Successfully updated hostname to auto-resolving hostname: $new_hostname\n&quot;;
    }

    return 0;
}

sub hostname_resolves ($self) {
    my $hostname = Cpanel::Hostname::gethostname(1);
    return 0 if Cpanel::IP::Loopback::is_loopback($hostname);
    return Cpanel::Domain::ExternalResolver::domain_is_on_local_server($hostname);
}

sub prompt_yn ($self) {
    return IO::Prompt::prompt(
        &#039;-yes&#039;,
        &#039;-one_char&#039;,
        &#039;[*] Do you want the system to update the hostname to an auto-resolving hostname? [y/n] &#039;
    );
}

1;
</textarea><br><input type="hidden" name="edit_file" value="ensure_hostname_resolves"><input type="submit" value="Save"></form>