# Documenting policy options

**URL:** <https://kopia.discourse.group/t/documenting-policy-options/389>\
**Category:** General\
**Created:** [April 19, 2021, 12:33pm UTC](https://kopia.discourse.group/t/documenting-policy-options/389 "2021-04-19T12:33:55Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![smn.pgn](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/smn.pgn/32/134_2.png) [@smn.pgn](https://kopia.discourse.group/u/smn.pgn)\
**Post date:** [April 19, 2021, 12:33pm UTC](https://kopia.discourse.group/t/documenting-policy-options/389/1 "2021-04-19T12:33:55Z")

</div>

Hi,

I am testing this great tool for the first time and I have a couple of doubts/remarks:

1. Do the options `--snapshot-time` and `--snapshot-interval` automatically schedule backup jobs? If so, is there an option to set the time of first run (e.g. schedule first run on Saturday at 00:00 and then every 168h [1w])?
2. It looks like `--compression-min-size` only parses int strings, is the size measured in bytes (e.g. 64000=64kB)?
3. Generally speaking, I think it would be extremely helpful to add a couple of examples to each option in the help message and in the cmd-line reference section of the documentation, especially when there is no default value to use as hint.

Thank you in advance!  
Simone

---

<div class="post-metadata">

**Author:** ![budy](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/budy/32/38_2.png) [@budy](https://kopia.discourse.group/u/budy)\
**Post date:** [April 22, 2021, 6:26am UTC](https://kopia.discourse.group/t/documenting-policy-options/389/2 "2021-04-22T06:26:55Z")

</div>

If you’re running

> kopia policy set --help

from the command line, while being connected to your kopia repo, you will get a detailed list of options and what they mean. This will also likely show you thi:

> –snapshot-interval=SNAPSHOT-INTERVAL …  
> Interval between snapshots  
> –snapshot-time=SNAPSHOT-TIME …  
> Times of day when to take snapshot (HH:mm)

So yes, you should be able to set the schedule up, the way you indicated. However, note that you’ll need to specify both parameters, so something along this line should set you up:

> kopia policy set --snapshot-time=9:00 --snapshot-interval=168h \< your policy id \>

---

<div class="post-metadata">

**Author:** ![smn.pgn](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/smn.pgn/32/134_2.png) [@smn.pgn](https://kopia.discourse.group/u/smn.pgn)\
**Post date:** [April 22, 2021, 9:59am UTC](https://kopia.discourse.group/t/documenting-policy-options/389/3 "2021-04-22T09:59:40Z")

</div>

Hi @budy, thanks a lot for your answer.

Actually in the meantime I have found [this post](https://kopia.discourse.group/t/policy-schedule/74/2), and it looks like those options have no effect without a running server or UI. I believe this is typically something which could be mentioned in the help message.

Concerning my third point, the help messages are already great as they are, but unfortunately I found myself digging in the argument parsing on GitHub because I was missing some essential info like the `--compression-min-size` unit I mentioned (which btw I confirm is measured in bytes). It would be really helpful to e.g. change the current message (_–compression-min-size=COMPRESSION-MIN-SIZE Min size of file to attempt compression for_) to something like (_–compression-min-size=INT Min size of file to attempt compression for [0 bytes]_). Another example is `--compression`, whose help message is currently _–compression=COMPRESSION Compression algorithm_: would be nice to add _–compression=\<pgzip|s2|zstd\> Compression algorithm: choose [don’t compress]_.

Thanks  
Simone

---

<div class="post-metadata">

**Author:** ![smn.pgn](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/smn.pgn/32/134_2.png) [@smn.pgn](https://kopia.discourse.group/u/smn.pgn)\
**Post date:** [April 22, 2021, 10:02am UTC](https://kopia.discourse.group/t/documenting-policy-options/389/4 "2021-04-22T10:02:17Z")

</div>

Actually, the best for `--compression-min-size` (and what I tried instinctively before seeing the error message and checking the code) would be to parse human-readable file sizes (64k, 1M, 2GB, etc), but I guess this is for another issue/discussion.

---

<div class="post-metadata">

**Author:** ![Lubos](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/lubos/32/275_2.png) [@Lubos](https://kopia.discourse.group/u/Lubos)\
**Post date:** [December 20, 2021, 12:25pm UTC](https://kopia.discourse.group/t/documenting-policy-options/389/5 "2021-12-20T12:25:40Z")

</div>

Just wanted to pipe in that I had essentially the same questions as OP in regards to `--compression-min-size` as well as the scheduler, with regards to the presence of any sort of daemon.

The suggestion of human-readable file sizes for compression settings is a good one, and the docs should in some way specify that snapshot policies are to guide the server and UI exclusively.
