pathwaycom/pathway · error · ValueError

'service_user_credentials_file' is required for the 'remote'

Error message

'service_user_credentials_file' is required for the 'remote' execution.

What it means

Error "'service_user_credentials_file' is required for the 'remote' execution." thrown in pathwaycom/pathway.

Source

Thrown at python/pathway/io/airbyte/__init__.py:383

    with open(config_file_path, "r") as f:
        yaml_config = f.read()

    source: AbstractAirbyteSource
    config = yaml.safe_load(yaml_config)
    source_config = config["source"]
    source_config["streams"] = streams
    if execution_type == "local":
        source = _construct_local_source(
            source_config,
            streams,
            env_vars,
            enforce_method,
            dependency_overrides,
        )
    elif execution_type == "remote":
        job_id = gcp_job_name or f"airbyte-serverless-{str(uuid.uuid4())}"
        if service_user_credentials_file is None:
            raise ValueError(
                "'service_user_credentials_file' is required for the 'remote' execution."
            )
        credentials = ServiceCredentials.from_service_account_file(
            service_user_credentials_file
        )
        source = RemoteAirbyteSource(
            config=config,
            streams=streams,
            job_id=job_id,
            credentials=credentials,
            region=gcp_region,
            env_vars=copy.copy(env_vars),
        )
    else:
        raise ValueError(
            f"Unknown execution type: {execution_type}. Only 'local' and 'remote' are supported."
        )

View on GitHub (pinned to fa2f74a464)

Solutions

1. Pass service_user_credentials_file=<path to the GCP service account JSON> when execution_type='remote'.

Example fix

pw.io.airbyte.read(..., execution_type='remote', service_user_credentials_file='/path/to/sa.json')

When it happens

Trigger: Thrown at python/pathway/io/airbyte/__init__.py:383 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of pathwaycom/pathway@fa2f74a464 (2026-08-15). Data as JSON: /api/errors/0f923087ccd2d23f. Report an issue: GitHub.