NAME

       mapproxy-seed - pre-generate tiles for MapProxy

SYNOPSIS

       mapproxy-seed [OPTIONS]

DESCRIPTION

       mapproxy-seed  pre-generates  tiles  for  MapProxy to improve the performance for commonly
       requested views, because MapProxy creates all tiles on demand otherwise.

       The tool can seed one or more polygon or BBOX areas for each cached layer.

       MapProxy does not seed the tile pyramid level by level, but  traverses  the  tile  pyramid
       depth-first,  from  bottom  to  top.   This  is  optimized to work with the caches of your
       operating system and geospatial database, and not against.

OPTIONS

       -s seed.yaml, --seed-conf seed.yaml
              The seed configuration.  You can also pass the configuration as the  last  argument
              to mapproxy-seed.

       -f mapproxy.yaml, --proxy-conf mapproxy.yaml
              The  MapProxy configuration to use.  This file should describe all caches and grids
              that the seed configuration references.

       -c N, --concurrency N
              The number of concurrent seed  worker.   Some  parts  of  the  seed  tool  are  CPU
              intensive  (image  splitting and encoding), use this option to distribute that load
              across multiple CPUs.  To limit the concurrent  requests  to  the  source  WMS  see
              wms_source_concurrent_requests_label.

       -n, --dry-run
              This  will  simulate  the  seed/cleanup  process  without  requesting,  creating or
              removing any tiles.

       --summary
              Print a summary of all seeding and cleanup tasks and exit.

       -i, --interactive
              Print a summary of each seeding and cleanup task and ask  if  mapproxy-seed  should
              seed/cleanup that task.  It will query for each task before it starts.

       --seed task1,task2,..
              Only  seed  the  named seeding tasks.  You can select multiple tasks with a list of
              comma separated names, or you can use the --seed option multiple  times.   You  can
              use  ALL  to select all tasks.  This disables all cleanup tasks unless you also use
              the --cleanup option.

       --cleanup task1,task2,..
              Only cleanup the named tasks.  You can select multiple tasks with a list  of  comma
              separated  names,  or you can use the --cleanup option multiple times.  You can use
              ALL to select all tasks.  This disables all seeding tasks unless you also  use  the
              --seed option.

       --continue
              Continue an interrupted seed progress.  MapProxy will start the seeding progress at
              the beginning if the progress file (--progress-file) was not found.   MapProxy  can
              only  continue  if  the  previous  seed  was  started  with  the --progress-file or
              --continue option.

       --progress-file
              Filename where MapProxy stores the seeding  progress  for  the  --continue  option.
              Defaults  to  .mapproxy_seed_progress  in  the current working directory.  MapProxy
              will remove that file after a successful seed.

       --duration
              Stop seeding process after this duration.  This  option  accepts  duration  in  the
              following  format:  120s,  15m,  4h,  0.5d  Use  this  option  in  combination with
              --continue to be able to resume the seeding.

       --reseed-file
              File created by mapproxy-seed at the start of a new seeding.

       --reseed-interval
              Only start seeding if --reseed-file is  older  then  this  duration.   This  option
              accepts  duration  in  the following format: 120s, 15m, 4h, 0.5d Use this option in
              combination with --continue to be able to resume the seeding.

       --use-cache-lock
              Lock each cache to prevent multiple parallel mapproxy-seed calls  to  work  on  the
              same cache.  It does not lock normal operation of MapProxy.

       --log-config
              The logging configuration file to use.

EXAMPLE

       Seed with concurrency of 4:

       mapproxy-seed -f mapproxy.yaml -c 4 seed.yaml

       Print summary of all seed tasks and exit:

       mapproxy-seed -f mapproxy.yaml -s seed.yaml --summary --seed ALL

       Interactively select which tasks should be seeded:

       mapproxy-seed -f mapproxy.yaml -s seed.yaml -i

       Seed task1 and task2 and cleanup task3 with concurrency of 2:

       mapproxy-seed -f mapproxy.yaml -s seed.yaml -c 2 --seed task1,task2 \
        --cleanup task3

                                         24 November 2021                        mapproxy-seed(1)