aboutsummaryrefslogtreecommitdiffstats
path: root/docs/config.rst
blob: 634b8703a144bd4febcbcee15a36f1701892250e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
.. _config:

Configuration
=============

Mitmproxy is configured through a set of files in the users ~/.mitmproxy
directory.

mitmproxy.conf
    Settings for the :program:`mitmproxy`. This file can contain any options supported by
    mitmproxy.

mitmdump.conf
    Settings for the :program:`mitmdump`. This file can contain any options supported by mitmdump.

common.conf
    Settings shared between all command-line tools. Settings in this file are over-ridden by those
    in the tool-specific files. Only options shared by mitmproxy and mitmdump should be used in
    this file.

Syntax
------

Comments
^^^^^^^^

.. code-block:: none

    # this is a comment
    ; this is also a comment (.ini style)
    --- and this is a comment too (yaml style)

Key/Value pairs
^^^^^^^^^^^^^^^

- Keys and values are case-sensitive
- Whitespace is ignored
- Lists are comma-delimited, and enclosed in square brackets

.. code-block:: none

    name = value   # (.ini style)
    name: value    # (yaml style)
    --name value   # (command-line option style)

    fruit = [apple, orange, lemon]
    indexes = [1, 12, 35 , 40]

Flags
^^^^^

These are boolean options that take no value but true/false.

.. code-block:: none

    name = true    # (.ini style)
    name
    --name 	 	   # (command-line option style)

Options
-------

The options available in the config files are precisely those available as
command-line flags, with the key being the option's long name. To get a
complete list of these, use the :option:`--help` option on each of the tools. Be
careful to only specify common options in the **common.conf** file -
unsupported options in this file will be detected as an error on startup.

Examples
--------

common.conf
^^^^^^^^^^^

Note that :option:`--port` is an option supported by all tools.

.. code-block:: none

    port = 8080

mitmproxy.conf
^^^^^^^^^^^^^^

.. code-block:: none

    palette = light