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

       2023, dev@trafficserver.apache.org