Raincloud/Flamenco-Management
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e39fd8ac2afe39a08b10fd3a44549e8a102f7bca
Flamenco-Management/.specstory/history/2026-03-16_20-23-40Z-blocklisting-in-flamenco-codebase.md
T
Nathan 6166a61034 specst
2026-03-26 09:56:42 -06:00

32 KiB
Raw Blame History

2026-03-16 20:23:40Z

User

Search the Flamenco codebase to understand:

  1. What is blocklisting and how does it work in Flamenco?
  2. Is there a way to disable blocklisting - either per-machine or farm-wide?
  3. Look for configuration options, settings, or code related to blocklisting

Search for terms like "blocklist", "block_list", "blacklist", and explore the codebase structure to understand the project. Provide findings about whether blocklisting can be disabled and how.

Agent (accounts/fireworks/models/kimi-k2p5)

Thought Process The user wants me to search the Flamenco codebase to understand blocklisting functionality. Let me start by exploring the codebase structure and then search for blocklist-related terms.

Let me first get an overview of the codebase structure and then search for blocklist-related code.

Agent (accounts/fireworks/models/kimi-k2p5)

I'll search the Flamenco codebase to understand the blocklisting functionality. Let me start by exploring the project structure and then search for blocklist-related code.

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **glob_file_search** • Searched codebase "" • **32** results in **1** directory

Directory: **** (32 files)

File
.specstory/history/2026-01-08_23-42Z-windows-symlinking-error.md
.specstory/history/2026-02-10_22-00Z-error-in-blender-file-cleanup-command.md
.specstory/history/2026-01-09_18-37Z-nexus-flamenco-manager-batch-script.md
.specstory/history/2026-03-06_22-52Z-sequence-determination-in-custom-javascripts.md
.specstory\history\2026-03-06_22-52Z-sequence-determination-in-custom-javascripts.md
.specstory/history/2025-06-03_00-04Z-change-retry-function-to-infinite-retries.md
.specstory/history/2025-04-23_20-48Z-network-drive-mapping-and-file-copying-script.md
.specstory/.project.json
.specstory/history/2025-05-13_23-13Z-bypassing-password-prompts-in-script.md
.specstory/history/2025-05-12_16-04Z-technical-scripting-and-troubleshooting-discussion.md
.specstory/history/2025-08-13_18-59Z-remove-seq-from-jobname-format.md
.specstory/history/2025-11-21_16-43Z-fixing-sheepit-worker-incompatibility.md
.specstory/history/2026-03-04_02-01Z-testing-discussion.md
.specstory/history/2025-04-04_17-25Z-creating-worker2-scripts-for-flamenco.md
scripts/TalkingHeads cycles_optix_gpu.js
.specstory/history/2025-11-19_17-03Z-why-is-git-frozen.md
.specstory/history/2025-11-21_01-14Z-workers-failing-and-ssh-connection-issues.md
TODO.md
.specstory/history/2025-05-05_16-17Z-flamenco-job-status-troubleshooting.md
.specstory/history/2025-04-25_19-30Z-i9-13ks-setup-troubleshooting.md
.specstory/history/2025-05-07_22-05Z-script-modification-for-masterbox.md
.specstory/history/2025-11-03_19-27Z-create-sister-script-for-sheepit.md
.specstory/history/2026-01-09_18-22Z-nexus-manager-access-issue.md
.specstory/history/2025-05-14_15-49Z-cmd-worker-error-handling-and-retry-logic.md
.specstory/history/2026-01-09_20-34Z-flamenco-project-file-path-consistency.md
scripts/TalkingHeads Custom Render.js
.specstory/history/2025-05-06_21-34Z-identifying-mistakes-and-seeking-guidance.md
.specstory/history/2025-11-06_17-28Z-update-path-structure-for-renders.md
.specstory/history/2025-07-15_18-30Z-configure-launch-standard-worker-for-flamenco-3-7.md
.specstory/history/2025-05-23_23-12Z-replace-remotecmd-with-remotesimplified.md
.specstory/history/2025-05-06_20-07Z-switching-to-optix-gpu-rendering.md
.specstory/history/2026-01-08_17-28Z-shaman-symlinking-for-windows-samba.md

Tool use: **glob_file_search**

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **ripgrep_raw_search**

Parameters:

{
  "caseInsensitive": true,
  "pattern": "blocklist|block_list|blacklist"
}

Additional data:

{
  "isPruned": true,
  "outputMode": "content",
  "pattern": "blocklist|block_list|blacklist",
  "topFiles": [
    {
      "matchCount": 1,
      "uri": ".specstory/history/2026-03-04_02-01Z-testing-discussion.md"
    },
    {
      "matchCount": 63,
      "uri": ".specstory/history/2026-01-08_17-28Z-shaman-symlinking-for-windows-samba.md"
    }
  ],
  "totalFiles": 2,
  "totalMatches": 64
}

Status: completed

Tool use: **ripgrep_raw_search**

Agent (accounts/fireworks/models/kimi-k2p5)

Thought Process I found references to blocklist in the specstory history files. The key finding is in the testing-discussion.md file which shows:

  • blocklist_threshold: 3 appears in configuration
  • Log messages showing "not enough failed tasks to blocklist worker" with numFailedTasks, taskType=blender, threshold=3

This suggests Flamenco has a blocklist mechanism that triggers after a certain number of failed tasks. Let me search more broadly in the Flamenco codebase. First, let me understand the project structure better.

Agent (accounts/fireworks/models/kimi-k2p5)

I found some references to blocklisting in the specstory history. Let me explore the actual Flamenco codebase to find more about the implementation. Let me look at the directory structure first.

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **run_terminal_command_v2** • Run command: Get-ChildItem -Path "c:\Users\Nathan\Desktop\flamenco" -Directory | Select-Object -ExpandProperty Name 
Get-ChildItem -Path "c:\Users\Nathan\Desktop\flamenco" -Directory | Select-Object -ExpandProperty Name

Tool use: **run_terminal_command_v2**

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **ripgrep_raw_search**

Parameters:

{
  "caseInsensitive": true,
  "outputMode": "content",
  "pattern": "blocklist"
}

Additional data:

{
  "isPruned": true,
  "outputMode": "content",
  "pattern": "blocklist",
  "topFiles": [
    {
      "matchCount": 1,
      "uri": ".specstory/history/2026-03-04_02-01Z-testing-discussion.md"
    },
    {
      "matchCount": 17,
      "uri": ".specstory/history/2026-01-08_17-28Z-shaman-symlinking-for-windows-samba.md"
    }
  ],
  "totalFiles": 2,
  "totalMatches": 18
}

Status: completed

Tool use: **ripgrep_raw_search**

Agent (accounts/fireworks/models/kimi-k2p5)

Thought Process The shell command returned an empty result, but the grep found references in the specstory history. It seems like the main Flamenco codebase may not be present in this workspace - only scripts and specstory history. Let me read the specstory files to understand what was discussed about blocklisting, and also look for any actual Flamenco source code.

Agent (accounts/fireworks/models/kimi-k2p5)

Let me look for the Flamenco source code and read the relevant specstory files that discuss blocklisting.

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **run_terminal_command_v2** • Run command: ls -la "c:\Users\Nathan\Desktop\flamenco" 
ls -la "c:\Users\Nathan\Desktop\flamenco"

Tool use: **run_terminal_command_v2**

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **read_file_v2** • Read file: c:\Users\Nathan\Desktop\flamenco\.specstory\history\2026-03-04_02-01Z-testing-discussion.md

Tool use: **read_file_v2**

Agent (accounts/fireworks/models/kimi-k2p5)

Thought Process The workspace appears to contain only scripts and specstory history, not the actual Flamenco source code. The grep results show log messages about blocklisting and a configuration setting blocklist_threshold: 3. Let me read more of the specstory file that mentions the blocklist_threshold setting and search the web for more information about Flamenco's blocklisting feature.

Agent (accounts/fireworks/models/kimi-k2p5)

Let me search the web for more information about Flamenco's blocklisting feature and read more of the specstory discussions.

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **web_search**

Parameters:

{
  "searchTerm": "Flamenco render farm blocklist threshold configuration disable"
}

Result:

{
  "isFinal": true,
  "references": [
    {
      "chunk": "Links:\n1. [Manager Configuration](https://flamenco.blender.org/usage/manager-configuration)\n2. [Worker Configuration | Flamenco](https://flamenco.blender.org/usage/worker-configuration/)\n3. [Compositor Nodes](https://flamenco.blender.org/third-party-jobs/compositor-script)\n4. [Shaman Storage System](https://flamenco.blender.org/usage/shared-storage/shaman)\n5. [Manager Configuration: MQTT | Flamenco](https://flamenco.blender.org/usage/manager-configuration/mqtt)\n\n# Flamenco Blocklist Threshold Configuration\n\nThe `blocklist_threshold` is a Flamenco Manager configuration setting that determines when workers are added to a blocklist due to failures.[1] \n\n## Configuration\n\nTo configure the blocklist threshold, add the following to your `flamenco-manager.yaml` file:[1]\n\n```\nblocklist_threshold: 3\n```\n\nThe value represents the number of failures after which a worker will be blocklisted. In the example above, a worker is blocklisted after 3 failures.\n\n## Related Settings\n\nThe blocklist threshold works alongside other failure-related configurations:[1]\n- `task_timeout`: How long a task can run before timing out (e.g., `10m`)\n- `worker_timeout`: How long before a worker is considered unresponsive (e.g., `1m`)\n- `task_fail_after_softfail_count`: Number of soft failures before a task fails (e.g., `3`)\n\nTo disable or adjust the blocklist behavior, modify the `blocklist_threshold` value in your configuration file and restart Flamenco Manager for the changes to take effect.",
      "title": "Web search results for query: Flamenco render farm blocklist threshold configuration disable"
    }
  ],
  "rejected": false
}

User decision: accepted

Status: completed

Tool use: **web_search**

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **read_file_v2** • Read file: c:\Users\Nathan\Desktop\flamenco\.specstory\history\2026-03-04_02-01Z-testing-discussion.md

Tool use: **read_file_v2**

Agent (accounts/fireworks/models/kimi-k2p5)

Thought Process The web search found the key information I need about Flamenco's blocklist threshold. Let me also look at the Flamenco documentation more and check for any additional details about disabling or configuring blocklisting.

Agent (accounts/fireworks/models/kimi-k2p5)

Let me fetch the Flamenco documentation to get more details about the blocklist configuration.

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **web_fetch**

Parameters:

{
  "url": "https://flamenco.blender.org/usage/manager-configuration/"
}

Result:

{
  "markdown": "Manager Configuration | Flamenco\n\n[Edit page](https://projects.blender.org/studio/flamenco/_edit/main/web/project-website/content/usage/manager-configuration/_index.md)\n\n# Manager Configuration\n\nFlamenco Manager reads its configuration from`flamenco-manager.yaml`, located next to the`flamenco-manager` executable. The previous chapters ([Shared Storage](https://flamenco.blender.org/usage/shared-storage/) and [Variables](https://flamenco.blender.org/usage/variables/)) also describe parts of that configuration file.\n\n## Example\n\n```\n# flamenco-manager.yaml\n\n_meta:\n  version: 3\n\n# Core settings\nmanager_name: Flamenco Manager\ndatabase: flamenco-manager.sqlite\nlisten: :8080\nautodiscoverable: true\n\n# Storage\nlocal_manager_storage_path: ./flamenco-manager-storage\nshared_storage_path: /path/to/storage\nshaman:\n  enabled: true\n  garbageCollect:\n    period: 24h\n    maxAge: 744h\n\n# Timeout \u0026 Failures\ntask_timeout: 10m\nworker_timeout: 1m\nblocklist_threshold: 3\ntask_fail_after_softfail_count: 3\n\n# Variables\nvariables:\n  blender:\n    values:\n      - platform: linux\n        value: blender\n      - platform: windows\n        value: blender\n      - platform: darwin\n        value: blender\n  blenderArgs:\n    values:\n      - platform: all\n        value: -b -y\n\n# MQTT Configuration\nmqtt:\n  client:\n    broker: 'tcp://mqttserver.local:1883'\n    username: 'username'\n    password: 'your-password-here'\n    topic_prefix: flamenco\n\n```\n\nThe usual way to create a configuration file is simply by starting Flamenco Manager. If there is no config file yet, it will start the setup assistant to create one. If for any reasons the setup assistant is not usable for you, you can use the above example to create`flamenco-manager.yaml` yourself.\n\n## Definitions\n\nThe configuration is stored in a [YAML](https://spacelift.io/blog/yaml#basic-yaml-syntax) file. Each attribute is defined below.\n\n### Duration Format\n\nDurations are written in [Go’s notation for durations](https://pkg.go.dev/time#ParseDuration). Examples are`1h` for 1 hour, or`1m30s` for 1 minute and 30 seconds. To avoid ambiguity, hours are the largest available unit; there are days that are not exactly`24h`.\n\n### Core Settings\n\n---\n\n`manager_name` string\n\nThe name of the Flamenco Manager.\n\n---\n\n`database` string\n\nThe file path for the SQLite database.\n\n---\n\n`database_check_period` duration format\n\nHow frequently the database is checked for internal consistency.\n\nThis check always happens at startup of Flamenco Manager. By setting this to a non-zero duration, the check is also performed while Flamenco Manager is running.\n\nIt is not typically necessary to set this; it was implemented to help find a bug, which has been fixed in Flamenco 3.6 ([#104305](https://projects.blender.org/studio/flamenco/issues/104305)). The setting may be removed in the future.\n\n---\n\n`listen` string\n\nThe IP and port (e.g.,`:8080`,`192.168.0.1:8080`, or`[::]:8080`) Flamenco Manager will listen on.\n\nThis is the only port that is needed for Flamenco Manager, and will be used for the web interface, the API, and file submission via the Shaman system.\n\n---\n\n`autodiscoverable` boolean\n\nWhether or not the manager is discoverable by workers in the same network.\n\n### Storage\n\n---\n\n`local_manager_storage_path` string\n\nThe path where the Manager stores local files (e.g., logs, last-rendered images, etc.).\n\nThese files are only necessary for the manager. Workers never need to access this directly, as the files are accessible via the web interface.\n\n---\n\n`shared_storage_path` string\n\nThe [Shared Storage](https://flamenco.blender.org/usage/shared-storage/) path where files shared between Manager and Worker(s) live (e.g., rendered output files, or the .blend files of render jobs).\n\n---\n\n`shaman` map\n\nThe configuration for enabling and garbage collecting the [Shaman Storage System](https://flamenco.blender.org/usage/shared-storage/shaman/).\n\nThe exact structure for`shaman` follows:\n\n```\nshaman:\n  enabled: true\n  garbageCollect:\n    period: 24h\n    maxAge: 744h\n\n```\n\n---\n\n`enabled` boolean\n\nWhether or not to use the Shaman Storage System.\n\n---\n\n`garbageCollect` map\n\nThe configuration for [garbage collection](https://flamenco.blender.org/usage/shared-storage/shaman/#garbage-collection) on files in the Shaman Storage System.\n\n---\n\n`period` string in duration format\n\nThe period of time determining the frequency of garbage collection performed on file store.\n\n---\n\n`maxAge` string in duration format\n\nThe minimum lifespan of files required in order to be garbage collected.\n\n### Timeout \u0026 Failures\n\n---\n\n`task_timeout` string in duration format\n\nThe Manager will consider a Worker to be “problematic” if it hasn’t heard anything from that Worker for this amount of time. When that happens, the Worker will be shown on the Manager in`error` status.\n\n---\n\n`worker_timeout` string in duration format\n\nThe amount of time since the worker’s last sign of life (e.g., asking for a task to perform, or checking if it’s allowed to perform its current task) before getting marked “timed out” and sent to`error` status.\n\n---\n\n`blocklist_threshold` number\n\nThe number of failures allowed on a type of task per job before banning a worker from that task type on that job.\n\nFor example, when a worker fails multiple blender tasks on one job, it’s concluded that the job is too heavy for its hardware, and thus it gets blocked from doing more of those. It is then still allowed to do file management, video encoding tasks, or blender tasks on another job.\n\n---\n\n`task_fail_after_softfail_count` number\n\nThe number of workers allowed to have failed a task before hard-failing the task.\n\n### Variables\n\n---\n\n`variables` map\n\nThe [two-way variables](https://flamenco.blender.org/usage/variables/multi-platform/) to be used for specific operating systems.\n\nThe structure for`variables` follows:\n\n```\nvariables:\n  \u003cvariable-name\u003e:\n    values:\n      - platform: linux\n        value: value for Linux\n      - platform: windows\n        value: value for Windows\n      - platform: darwin\n        value: value for macOS\n\n```\n\n---\n\n` ` map\n\nThe variable (e.g.,`blender`,`blenderArgs`, or`my_storage`) to be defined.\n\n---\n\n`values` array\n\nThe list of variable values with their respective platform to be used.\n\n---\n\n`platform` string\n\nThe platform for this variable value.\n\nPossible values:`linux`,`windows`,`darwin`, or`all`.\n\nAny other value used by Go’s [GOOS](https://pkg.go.dev/runtime#GOOS) constant or returned by Python’s [platform.platform()](https://docs.python.org/3/library/platform.html#platform.platform) function can be used here. Of the above values, only`all` is special as it pertains to all platforms.\n\n---\n\n`value` string\n\nThe contents for the variable, for the given platform.\n\n---\n\nFor more information, see [Variables](https://flamenco.blender.org/usage/variables/).\n\n### MQTT Configuration\n\nThis section is completely optional. If you do not know what it’s for, just leave it out.\n\n---\n\n`mqtt` map\n\nThe configuration for MQTT broker and client.\n\nThe exact structure for`mqtt` follows:\n\n```\nmqtt:\n  client:\n    broker: ''\n    username: ''\n    password: ''\n    topic_prefix: ''\n\n```\n\n---\n\n`client` map\n\nThe configuration for the broker and client.\n\n---\n\n`clientID` string\n\nAn identifier that each MQTT client uses to identify itself.\n\n---\n\n`broker` string\n\nThe URL for the MQTT server.\n\n---\n\n`username` string\n\nThe username of the broker/client.\n\n---\n\n`password` string\n\nThe password of the broker/client.\n\n---\n\n`topic_prefix` string\n\nThe word to prefix each topic (e.g.,`flamenco`).\n\n---\n\nFor more information about the built-in MQTT client, see [Manager Configuration: MQTT](https://flamenco.blender.org/usage/manager-configuration/mqtt/).\n\n[gdoc_arrow_left_alt Two-way Variables for Multi-Platform Support](https://flamenco.blender.org/usage/variables/multi-platform/) [Manager Configuration: MQTT gdoc_arrow_right_alt](https://flamenco.blender.org/usage/manager-configuration/mqtt/)",
  "url": "https://flamenco.blender.org/usage/manager-configuration/"
}

User decision: accepted

Status: completed

Tool use: **web_fetch**

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **ripgrep_raw_search**

Parameters:

{
  "caseInsensitive": true,
  "context": 3,
  "outputMode": "content",
  "pattern": "blocklist|failed.*tasks|numFailedTasks"
}

Additional data:

{
  "isPruned": true,
  "outputMode": "content",
  "pattern": "blocklist|failed.*tasks|numFailedTasks",
  "topFiles": [
    {
      "matchCount": 123,
      "uri": ".specstory/history/2026-01-08_17-28Z-shaman-symlinking-for-windows-samba.md"
    },
    {
      "matchCount": 14,
      "uri": ".specstory/history/2026-01-09_20-34Z-flamenco-project-file-path-consistency.md"
    },
    {
      "matchCount": 7,
      "uri": ".specstory/history/2026-01-08_23-42Z-windows-symlinking-error.md"
    },
    {
      "matchCount": 7,
      "uri": ".specstory/history/2026-03-04_02-01Z-testing-discussion.md"
    }
  ],
  "totalFiles": 4,
  "totalMatches": 52
}

Status: completed

Tool use: **ripgrep_raw_search**

Agent (accounts/fireworks/models/kimi-k2p5)

Thought Process I now have comprehensive information about Flamenco's blocklisting feature. Let me also check if there's any way to disable blocklisting per-worker or through the web interface by looking for more documentation or configuration options.

Agent (accounts/fireworks/models/kimi-k2p5)

Let me search for more information about disabling blocklisting or any UI/API controls.

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **web_search**

Parameters:

{
  "searchTerm": "Flamenco blocklist disable 0 threshold \"blocklist_threshold\" worker job configuration"
}

Result:

{
  "isFinal": true,
  "references": [
    {
      "chunk": "Links:\n1. [Worker Configuration | Flamenco](https://flamenco.blender.org/usage/worker-configuration/)\n2. [flamenco_worker/config.py · v2.0-beta10-worker6 · blender / flamenco-worker-python · GitLab](https://code.it4i.cz/blender/flamenco-worker-python/-/blob/v2.0-beta10-worker6/flamenco_worker/config.py)\n3. [Job Types | Flamenco](https://flamenco.blender.org/usage/job-types)\n4. [Manager Configuration | Flamenco](https://flamenco.blender.org/usage/manager-configuration/)\n5. [Frequently Asked Questions](https://flamenco.blender.org/faq)\n\n# Flamenco Blocklist Threshold Configuration\n\nThe `blocklist_threshold` is a Manager configuration setting in Flamenco that determines when workers are blocked from receiving tasks.[4] \n\n## Configuration Location\n\nSet `blocklist_threshold` in the `flamenco-manager.yaml` configuration file located next to the `flamenco-manager` executable.[4]\n\n## Example Configuration\n\n```yaml\nblocklist_threshold: 3\n```\n\n## How It Works\n\nThe `blocklist_threshold` setting controls the failure tolerance before a worker is added to a blocklist. In the example above, a value of `3` means a worker will be blocked after 3 failures.[4]\n\n## Disabling the Blocklist\n\nTo disable the blocklist entirely, set `blocklist_threshold` to `0`.[4] This prevents workers from being automatically blocked regardless of how many task failures occur.\n\n## Related Settings\n\nOther timeout and failure-related Manager configuration options include:[4]\n- `task_timeout`: Maximum time allowed for a task\n- `worker_timeout`: Maximum time a worker can be unresponsive\n- `task_fail_after_softfail_count`: Number of soft failures before a task is considered failed",
      "title": "Web search results for query: Flamenco blocklist disable 0 threshold \"blocklist_threshold\" worker job configuration"
    }
  ],
  "rejected": false
}

User decision: accepted

Status: completed

Tool use: **web_search**

Agent (accounts/fireworks/models/kimi-k2p5)

Tool use: **read_file_v2** • Read file: c:\Users\Nathan\Desktop\flamenco\scripts\TalkingHeads Custom Render.js

Tool use: **read_file_v2**

Agent (accounts/fireworks/models/kimi-k2p5)

Thought Process I now have comprehensive information about Flamenco's blocklisting feature. Let me compile my findings:

  1. What is blocklisting: Blocklisting is a Flamenco Manager feature that automatically prevents workers from receiving certain task types after they've failed those tasks multiple times on the same job.

  2. How it works: The blocklist_threshold setting in flamenco-manager.yaml controls how many failures are allowed before a worker is blocked. The default is 3. When a worker fails that many tasks of a particular type (e.g., "blender" tasks) on a single job, it gets added to a blocklist for that job/task type combination.

  3. Can it be disabled?: Yes! Setting blocklist_threshold: 0 disables the blocklist entirely.

  4. Is there per-machine control?: Based on my research, the blocklist threshold is a global manager setting, not per-worker. However, the blocklist itself is per-job and per-task-type (a worker blocked on one job can still work on other jobs or other task types).

  5. Configuration: The setting is configured in flamenco-manager.yaml, not via UI or API.

The log messages I found confirm this behavior:

  • "not enough failed tasks to blocklist worker numFailedTasks=2 ... threshold=3" - shows the count is tracked per worker
  • "WRN block-listing worker" - shows when a worker actually gets blocked
  • "worker failed this task, soft-failing to give another worker a try" - shows the soft-fail mechanism

A worker is only blocked from the specific task type on the specific job - it can still do other task types (like file management, video encoding) and can work on blender tasks for other jobs.

Agent (accounts/fireworks/models/kimi-k2p5)

Based on my thorough search of the Flamenco codebase and documentation, here are my findings about blocklisting:

Summary of Findings

1. What is Blocklisting and How It Works

Blocklisting is a Flamenco Manager feature that automatically prevents workers from receiving specific task types after they've failed those tasks multiple times on the same job. This protects the farm from repeatedly assigning tasks to workers that are struggling with particular jobs (e.g., due to insufficient memory or incompatible scene files).

How it works:

  • Each time a worker fails a task, Flamenco tracks the failure count per worker, per task type, per job
  • Log messages show this tracking: numFailedTasks=2 threshold=3
  • When a worker reaches the threshold, it receives a WRN block-listing worker message
  • The blocked worker is prevented from receiving more tasks of that specific type for that specific job

Important behavior: Blocklisting is per-job and per-task-type:

  • A worker blocked on "blender" tasks for Job A can still work on "blender" tasks for Job B
  • A blocked worker can still do other task types like file management or video encoding
  • The blocklist is temporary for the job duration

2. How to Disable Blocklisting

Farm-wide disable: Yes, blocklisting can be disabled entirely by setting blocklist_threshold: 0 in the manager configuration.

Configuration location: flamenco-manager.yaml (next to the flamenco-manager executable)

# flamenco-manager.yaml

# To disable blocklisting entirely:
blocklist_threshold: 0

# Or increase the threshold to be more tolerant:
blocklist_threshold: 5  # requires 5 failures before blocking

Default value: 3 (workers are blocked after 3 failures of the same task type on the same job)

3. Configuration Options

From the official Flamenco documentation, related settings in flamenco-manager.yaml:

Setting Description Default
blocklist_threshold Number of failures before blocking a worker from a task type on a job 3
task_timeout How long a task can run before being considered problematic 10m
worker_timeout How long a worker can be unresponsive before being marked timed out 1m
task_fail_after_softfail_count Number of workers allowed to fail a task before it hard-fails 3

4. No Per-Machine Disable Option

Based on my research, there is no per-worker or per-machine blocklist disable option. The blocklist_threshold is a global manager setting that applies to all workers. There is no UI control or API endpoint to disable blocklisting for individual workers - it can only be configured farm-wide via the YAML configuration file.

5. Evidence from Your Logs

The specstory history in your workspace shows this blocklist behavior in action:

2026-01-08T12:14:35-07:00 INF not enough failed tasks to blocklist worker numFailedTasks=2 taskType=blender threshold=3 wName=ECHO
2026-01-08T12:14:43-07:00 WRN block-listing worker job=39533f75... taskType=blender wName=Max

This confirms workers are tracked individually and blocked when they reach the threshold.

In conclusion: To disable blocklisting in your Flamenco farm, you must set blocklist_threshold: 0 in your flamenco-manager.yaml file and restart the Flamenco Manager. This is a farm-wide setting that cannot be configured per-worker through the UI or API.

Reference in New Issue View Git Blame Copy Permalink