NAME

       hosting.config - Traffic Server domain hosting configuration file

       The hosting.config file (by default, located in /usr/local/etc/trafficserver/) allows you to assign cache
       volumes  to  specific  origin  servers  and/or domains so that you can manage cache space efficiently and
       restrict disk usage. For step-by-step instructions on partitioning the cache according to origin  servers
       and/or domains, refer to Partitioning the Cache.

       Before  you  can assign cache volumes to specific origin servers and/or domains, you must first partition
       your cache according to size and protocol in the volume.config file.

       After you modify hosting.config, navigate to the Traffic Server bin directory and run traffic_ctl  config
       reload to apply your changes.

FORMAT

       Each line in the hosting.config file must have one of the following formats:

          hostname=HOST volume=NUMBERS
          domain=DOMAIN volume=NUMBERS

       where  HOST  is  the  fully-qualified  hostname of the origin server whose content you want to store on a
       particular volume (for example, www.myhost.com); DOMAIN is the domain whose content you want to store  on
       a  particular  partition  (for  example,  mydomain.com);  and  NUMBERS  is  a comma-separated list of the
       partitions on which you want to store the content that belongs to the origin server or domain listed. The
       partition numbers must be valid numbers listed in the volume.config.

       Note: To allocate more than one partition to an origin server or domain, you must enter the partitions in
       a comma-separated list on one line, as shown in the example below. The hosting.config file cannot contain
       multiple entries for the same origin server or domain.

GENERIC PARTITION

       When configuring the hosting.config file, you must assign a generic volume to use for content  that  does
       not  belong to any of the origin servers or domains listed. If all volumes for a particular origin server
       become corrupt, Traffic Server will also use the generic volume to store content for that origin server.

       The generic volume must have the following format:

          hostname=* volume=NUMBERS

       where NUMBERS is a comma-separated list of generic volumes.

EXAMPLES

       The following example configures Traffic Server to store content from the domain mydomain.com in volume 1
       and content from www.myhost.com in volume 2. Traffic Server stores content from all other origin  servers
       in volumes 3 and 4.

          domain=mydomain.com volume=1
          hostname=www.myhost.com volume=2
          hostname=* volume=3,4

COPYRIGHT

       2025, dev@trafficserver.apache.org

9.2                                               May 22, 2025                                 HOSTING.CONFIG(5)