connman.conf

connman.conf(5)                                                  connman.conf(5)



NAME
       main.conf - ConnMan configuration file

SYNOPSIS
       /etc/connman/main.conf
       or
       <SYSCONFDIR>/connman/main.conf
       where <SYSCONFDIR> depends on your distribution or build.

DESCRIPTION
       main.conf  is a configuration file for ConnMan. The configuration file is
       optional but it can be used  to  set  up  various  aspects  of  ConnMan's
       behavior.  The  location  of  the  file may be changed through use of the
       "--config=" argument for connman (8).

FILE FORMAT
       The configuration file  format  is  key  file  format.   It  consists  of
       sections  (groups)  of  key-value  pairs.  Lines beginning with a '#' and
       blank lines are considered comments.  Sections are started  by  a  header
       line containing the section enclosed in '[' and ']', and ended implicitly
       by the start of the next section or the end of the file.  Each  key-value
       pair must be contained in a section.

       Description of sections and available keys follows:

   [General]
       This section is the only mandatory section of the configuration file.

       InputRequestTimeout=secs
              Set  input request timeout. Default is 120 seconds The request for
              inputs like passphrase will timeout after certain amount of  time.
              Use  this  setting to increase the value in case of different user
              interface designs.

       BrowserLaunchTimeout=secs
              Set browser launch timeout. Default is 300 seconds The request for
              launching  a  browser  for portal pages will timeout after certain
              amount of time. Use this setting to increase the value in case  of
              different user interface designs.

       BackgroundScanning=true|false
              Enable  background scanning. Default is true.  Background scanning
              will start every 5 minutes unless the scan list is empty. In  that
              case, a simple backoff mechanism starting from 10s up to 5 minutes
              will run.

       FallbackTimeservers=server1,server2,...
              List of Fallback timeservers separated by ",".  These  timeservers
              are used for NTP sync when there are no timeserver set by the user
              or by the service.  These can contain mixed combination  of  fully
              qualified domain names, IPv4 and IPv6 addresses.

       FallbackNameservers=server1,server2,...
              List of fallback nameservers separated by "," appended to the list
              of nameservers given by the service. The nameserver  entries  must
              be in numeric format, host names are ignored.

       DefaultAutoConnectTechnologies=technology1,technology2,...
              List  of  technologies that are marked autoconnectable by default,
              separated by commas ",". The default value  for  this  entry  when
              empty  is ethernet,wifi,cellular.  Services that are automatically
              connected must have been set up and saved to storage beforehand.

       PreferredTechnologies=technology1,technology2,...
              List of preferred technologies from the most preferred one to  the
              least  preferred  one  separated  by  commas ",".  Services of the
              listed technology type will be tried  one  by  one  in  the  order
              given,  until  one of them gets connected or they are all tried. A
              service of a preferred technology type in state 'ready'  will  get
              the  default route when compared to another preferred type further
              down the list with state 'ready' or with a non-preferred  type;  a
              service  of a preferred technology type in state 'online' will get
              the default route when compared to either a non-preferred type  or
              a preferred type further down in the list.

       NetworkInterfaceBlacklist=interface1,interface2,...
              List  of  blacklisted  network interfaces separated by ",".  Found
              interfaces will be compared to the list and will not be handled by
              connman,  if their first characters match any of the list entries.
              Default value is vmnet,vboxnet,virbr.

       AllowHostnameUpdates=true|false
              Allow connman to change the system hostname. This can  happen  for
              example  if  we  receive  DHCP  hostname option.  Default value is
              true.

       SingleConnectedTechnology=true|false
              Keep only a single connected technology at any time.  When  a  new
              service  is  connected  by  the  user  or  a  better  one is found
              according  to  PreferredTechnologies,  the  new  service  is  kept
              connected  and  all  the  other  previously connected services are
              disconnected. With this setting it does  not  matter  whether  the
              previously  connected  services are in 'online' or 'ready' states,
              the newly connected service is the only  one  that  will  be  kept
              connected.  A  service  connected  by  the user will be used until
              going  out  of  network  coverage.  With  this   setting   enabled
              applications  will notice more network breaks than normal. Default
              value is false.

       TetheringTechnologies=technology1,technology2,...
              List  of  technologies  that  are  allowed  to  enable   tethering
              separated  by  ",".   The  default value is wifi,bluetooth,gadget.
              Only those technologies listed here are used for tethering. If one
              wants  to  tether ethernet, then add "ethernet" in the list.  NOTE
              that if ethernet tethering is  enabled,  then  a  DHCP  server  is
              started on all ethernet interfaces. Tethered ethernet should never
              be connected to corporate or  home  network  as  it  will  disrupt
              normal  operation  of  these networks. Due to this ethernet is not
              tethered by default. Do not activate ethernet tethering unless you
              really know what you are doing.

       PersistentTetheringMode=true|false
              Restore earlier tethering status when returning from offline mode,
              re-enabling a technology, and after restarts and reboots.  Default
              value is false.