Child pages
  • How to Assign Dedicated IP Addresses to Subdomains
Skip to end of metadata
Go to start of metadata

Overview

This document describes how to manually assign a dedicated IP address to a user's subdomain. You can assign a dedicated IP address to a user's subdomain for either of the following reasons:

  • The subdomain requires an SSL certificate.
  • The subdomain hosts an anonymous FTP site.

Important:

The following organizations' IP address usage policies all follow Requests For Comments (RFC) 2050:

RFC 2050 states the following:

ISPs are required to utilize address space in an efficient manner. To this end, ISPs should have documented justification available for each assignment. The regional registry may, at any time, ask for this information. If the information is not available, future allocations may be impacted. In extreme cases, existing loans may be impacted.

Note:

You can also use the procedure that this document describes to assign dedicated IP addresses to addon domains.

Assign a dedicated IP address to a subdomain

To assign a dedicated IP address to a subdomain, perform the following steps:

Step 1: Add the dedicated IP address to the user's subdomain file.

Note:

In this example, subdomain.example.com represents the subdomain to which to assign a dedicated IP address.

To add the dedicated IP address to the subdomain.example.com file, perform the following steps:

  1. Log in to the server as the root user via SSH.
  2. Navigate to the /var/cpanel/userdata/username directory.

    Note:

    username represents the user who requires that each subdomain use a dedicated IP address.

  3. Open the subdomain.example.com file with a text editor. The file's contents will resemble the following example:

    customlog:
      -
        format: combined
        target: /usr/local/apache/domlogs/example.com
      -
        format: "\"%{%s}t %I .\\n%{%s}t %O .\""
        target: /usr/local/apache/domlogs/example.com-bytes_log
    documentroot: /home/username/public_html
    group: Group1
    hascgi: 1
    homedir: /home/username
    ip: 192.168.0.1
    owner: username
    phpopenbasedirprotect: 1
    port: 80
    scriptalias:
      -
        path: /home/username/public_html/cgi-bin
        url: /cgi-bin/
      -
        path: /home/username/public_html/cgi-bin/
        url: /cgi-bin/
    serveradmin: webmaster@example.com
    serveralias: www.example.com
    servername: example.com
    usecanonicalname: 'Off'
    user: username
    userdirprotect: ''
  4. Change the ip line to reflect the dedicated IP address to assign to the subdomain, for example:

    ip: 192.168.0.20

    Important:

    On servers that use the 1:1 NAT configuration, you must add the server's internal IP address to this file.

Step 2: Rebuild and restart Apache

After you modify the appropriate files, rebuild and restart Apache. To do this, perform either of the following actions:

  • Manually rebuild and restart Apache. To do this, run the following commands:

    /usr/local/cpanel/scripts/rebuildhttpdconf
    /usr/local/cpanel/scripts/restartsrv_apache
  • Rebuild and restart Apache in WHM's Restart Services interface (Home >> Services >> Restart Services).

Step 3: Add the IP address to the nameserver records

Add the subdomain's dedicated IP address to the server's nameserver records. To do this, use either of the following methods:

Step 4: Reserve the dedicated IP address

To reserve the subdomain's dedicated IP address, Add the subdomains' dedicated IP address to the reserved IP list so that the system does not assign it other accounts or sites. Perform this action in WHM's Show Edit Reserved IPs interface (Home >> IP Functions >> Show/Edit Reserved IPs).

Additional documentation