id,page,ref,title,content,breadcrumbs,references
configuration:configuration-cli,configuration,configuration-cli,Configuration via the command-line,"The recommended way to configure Datasette is using a  datasette.yaml  file passed to  -c/--config . You can also pass individual settings to Datasette using the  -s/--setting  option, which can be used multiple times: 
             datasette mydatabase.db \
  --setting settings.default_page_size 50 \
  --setting settings.sql_time_limit_ms 3500 
             This option takes dotted-notation for the first argument and a value for the second argument. This means you can use it to set any configuration value that would be valid in a  datasette.yaml  file. 
             It also works for plugin configuration, for example for  datasette-cluster-map : 
             datasette mydatabase.db \
  --setting plugins.datasette-cluster-map.latitude_column xlat \
  --setting plugins.datasette-cluster-map.longitude_column xlon 
             If the value you provide is a valid JSON object or list it will be treated as nested data, allowing you to configure plugins that accept lists such as  datasette-proxy-url : 
             datasette mydatabase.db \
  -s plugins.datasette-proxy-url.paths '[{""path"": ""/proxy"", ""backend"": ""http://example.com/""}]' 
             This is equivalent to a  datasette.yaml  file containing the following: 
             [[[cog
from metadata_doc import config_example
import textwrap
config_example(cog, textwrap.dedent(
  """"""
  plugins:
    datasette-proxy-url:
      paths:
      - path: /proxy
        backend: http://example.com/
  """""").strip()
  ) 
             ]]] 
             [[[end]]]","[""Configuration""]","[{""href"": ""https://datasette.io/plugins/datasette-cluster-map"", ""label"": ""datasette-cluster-map""}, {""href"": ""https://datasette.io/plugins/datasette-proxy-url"", ""label"": ""datasette-proxy-url""}]"
configuration:configuration-reference,configuration,configuration-reference,,"The following example shows some of the valid configuration options that can exist inside  datasette.yaml . 
             [[[cog
from metadata_doc import config_example
import textwrap
config_example(cog, textwrap.dedent(
  """"""
    # Datasette settings block
    settings:
      default_page_size: 50
      sql_time_limit_ms: 3500
      max_returned_rows: 2000

    # top-level plugin configuration
    plugins:
      datasette-my-plugin:
        key: valueA

    # Database and table-level configuration
    databases:
      your_db_name:
        # plugin configuration for the your_db_name database
        plugins:
          datasette-my-plugin:
            key: valueA
        tables:
          your_table_name:
            allow:
              # Only the root user can access this table
              id: root
            # plugin configuration for the your_table_name table
            # inside your_db_name database
            plugins:
              datasette-my-plugin:
                key: valueB
    """""")
  ) 
             ]]] 
             [[[end]]]","[""Configuration""]",[]