{
  "id": "Configuration_Reference",
  "title": "Configuration Reference",
  "url": "https://swarmglass.quantara.cv/wiki/Configuration_Reference",
  "archive_ref": "QUANTARA-SWARMGLASS-R15-C7A852",
  "kind": "article",
  "status": "current",
  "categories": [
    "Reference",
    "Operations"
  ],
  "created": "2011-05-02",
  "modified": "2016-02-22",
  "revisions": 40,
  "authors": [
    "mkerrigan",
    "svanterpool",
    "dlopes"
  ],
  "infobox": {
    "Files": "/etc/antfarm/*.conf",
    "Format": "INI-ish, one section per service",
    "Reload": "SIGHUP (most services)"
  },
  "summary": "All  services read from /etc/antfarm/. Files are simple key = value under a section header. Comments start with #. Booleans are true/false. Durations are seconds unless the key ends in _ms.",
  "links": [
    {
      "target": "Known_Agent_Bugs",
      "url": "https://swarmglass.quantara.cv/wiki/Known_Agent_Bugs"
    },
    {
      "target": "Worker_Node_Registry",
      "url": "https://swarmglass.quantara.cv/wiki/Worker_Node_Registry"
    },
    {
      "target": "Orchestrator_Recovery",
      "url": "https://swarmglass.quantara.cv/wiki/Orchestrator_Recovery"
    },
    {
      "target": "Getting_Started",
      "url": "https://swarmglass.quantara.cv/wiki/Getting_Started"
    }
  ],
  "alternates": [
    "https://swarmglass.quantara.cv/wiki/Configuration_Reference.json",
    "https://swarmglass.quantara.cv/wiki/Configuration_Reference.yaml",
    "https://swarmglass.quantara.cv/wiki/Configuration_Reference.txt"
  ],
  "text": "All ANTFARM services read from `/etc/antfarm/`. Files are simple `key = value` under a section header. Comments start with `#`. Booleans are `true`/`false`. Durations are seconds unless the key ends in `_ms`.\n\nSingle-host development config: [attachment: antfarm-singlehost.conf].\n\n== queen ==\n\n```\n[queen]\nname            = queen01\nlisten          = 0.0.0.0:7420\nbus             = phero-a.hm.internal:7421\npeer            = queen02.hm.internal:7420\nepoch_file      = /var/lib/antfarm/epoch\nassign_timeout  = 300        # reissue after this many seconds\nhb_interval     = 10\nhb_miss_evict   = 3\nelection_min_ms = 1500       # see Queen election notes (not on this wiki)\nhosts_file      = /etc/antfarm/hosts.yaml\n```\n\n`assign_timeout` is the value that makes AF-44 happen. Lowering it makes it happen more.\n\n== forager ==\n\n```\n[forager]\nname            = forager-07\nqueen           = queen01.hm.internal:7420\nbus             = phero-a.hm.internal:7421\nslots           = 2\ncapabilities    = fetch,convert,index,model.shard0\ncm_cache_ttl    = 120\nmanifest_cache  = /var/cache/antfarm/manifest.json\nmodel.strict    = false      # true: missing loader is an error, not a fallback\nmodel.conf      = /etc/antfarm/model.conf\n```\n\n== phero ==\n\n```\n[phero]\nlisten          = 0.0.0.0:7421\ndata_dir        = /var/lib/phero\ntrail_log_size  = 10000      # messages kept per trail for replay\ntrail_log_bytes = 0          # 0 = unlimited. see AF-70.\nstats_listen    = 127.0.0.1:7421   # sic — same port, different bind, works by accident\n```\n\n== cmsync ==\n\n```\n[cmsync]\nlisten          = 0.0.0.0:7422\npeer            = queen02.hm.internal:7422\nsync_interval   = 2\nfull_resync_after = 60\nsnapshot_dir    = /var/backups/cmsync\n```\n\n== toolreg ==\n\n```\n[toolreg]\nlisten          = 0.0.0.0:7423\nmanifest        = /etc/antfarm/manifest.json\nschema          = toolreg/2\n```\n\n== antc ==\n\n`antc` has no config file. It reads `ANTC_MANIFEST` from the environment and defaults to `http://toolreg.hm.internal:7423/manifest.json`.\n\n== inference (3.0+) ==\n\n```\n[inference]\nsplit           = 1          # shards; see Distributed_Inference_Notes\nshard_hosts     = forager-07,forager-09,forager-12,forager-14\nwarmup_wait     = true\nact_encoding    = base64     # the only value that was ever implemented\n```\n\n== Reloading ==\n\n`SIGHUP` reloads `queen`, `forager`, `toolreg`. `phero` and `cmsync` need a restart; `phero` keeps its replay log across restarts, `cmsync` does a full resync on start.\n\n== See also ==\n\n- Worker Node Registry\n- Orchestrator Recovery\n- Getting Started#Local setup\n",
  "history": "https://swarmglass.quantara.cv/wiki/Configuration_Reference?action=history",
  "latest_revision": 82053,
  "mirror": {
    "source": "ANTFARM Wiki",
    "seed_version": "2026.09.0",
    "generator": "AntWiki 1.16.5 (swarmglass mirror)"
  }
}