# Shared File Systems API configuration

## Configuration options

The following options allow configuration of the APIs that Shared File Systems service supports.

Description of API configuration options
Configuration option = Default value | Description
--- | ---
[DEFAULT] |
`admin_network_config_group` = `None` | (String) If share driver requires to setup admin network for share, then define network plugin config options in some separate config group and set its name here. Used only with another option ‘driver_handles_share_servers’ set to ‘True’.
`admin_network_id` = `None` | (String) ID of neutron network used to communicate with admin network, to create additional admin export locations on.
`admin_subnet_id` = `None` | (String) ID of neutron subnet used to communicate with admin network, to create additional admin export locations on. Related to ‘admin_network_id’.
`api_paste_config` = `api-paste.ini` | (String) File name for the paste.deploy config for manila-api.
`api_rate_limit` = `True` | (Boolean) Whether to rate limit the API.
`db_backend` = `sqlalchemy` | (String) The backend to use for database.
`max_header_line` = `16384` | (Integer) Maximum line size of message headers to be accepted. Option max_header_line may need to be increased when using large tokens (typically those generated by the Keystone v3 API with big service catalogs).
`osapi_max_limit` = `1000` | (Integer) The maximum number of items returned in a single response from a collection resource.
`osapi_share_base_URL` = `None` | (String) Base URL to be presented to users in links to the Share API
`osapi_share_ext_list` = | (List) Specify list of extensions to load when using osapi_share_extension option with manila.api.contrib.select_extensions.
`osapi_share_extension` = `manila.api.contrib.standard_extensions` | (List) The osapi share extensions to load.
`osapi_share_listen` = `::` | (String) IP address for OpenStack Share API to listen on.
`osapi_share_listen_port` = `8786` | (Port number) Port for OpenStack Share API to listen on.
`osapi_share_workers` = `1` | (Integer) Number of workers for OpenStack Share API service.
`share_api_class` = `manila.share.api.API` | (String) The full class name of the share API class to use.
`volume_api_class` = `manila.volume.cinder.API` | (String) The full class name of the Volume API class to use.
`volume_name_template` = `manila-share-%s` | (String) Volume name template.
`volume_snapshot_name_template` = `manila-snapshot-%s` | (String) Volume snapshot name template.
[oslo_middleware] |
`enable_proxy_headers_parsing` = `False` | (Boolean) Whether the application is behind a proxy or not. This determines if the middleware should parse the headers or not.
`max_request_body_size` = `114688` | (Integer) The maximum body size for each request, in bytes.
`secure_proxy_ssl_header` = `X-Forwarded-Proto` | (String) DEPRECATED: The HTTP Header that will be used to determine what the original request protocol scheme was, even if it was hidden by a SSL termination proxy.

this page last updated: 2026-03-20 00:20:57

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug