Error setting the webreceiverstyle

[vara-ti]

Describe the bug

Error: Error setting Site Style for the StoreFront WebReceiver
│
│ with module.webreceiver_service.citrix_stf_webreceiver_service.this,
│ on modules\webreceiverservice\main.tf line 15, in resource "citrix_stf_webreceiver_service" "this":
│ 15: resource "citrix_stf_webreceiver_service" "this" {
│
│ Error message: error executing command: Set-STFWebReceiverSiteStyle
│ Error Message:
│ C:\inetpub\wwwroot\Citrix\VDIUATWeb\custom\Citrix_HalfHeaderLogo.png
│ + CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
│ + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

Terraform command (import, apply, etc):
Resource impacted:

Issue reproducible outside of Terraform:
No, works with powershell outside of terraform

Versions

**Terraform: v1.7.3
**citrix/citrix provider: v1.0.30
**Operation system: Windows Server 2019

**Environment type: On prem
Hypervisor type (if applicable):

CVAD (DDC, VDA, etc):
**Storefront:2507

Terraform configuration files

Terraform console output

Terraform log file

set TF_LOG="DEBUG"
set TF_LOG_PATH="./citrix-provider-issue.txt"
terraform <command>

$env:TF_LOG="DEBUG"
$env:TF_LOG_PATH="./citrix-provider-issue.txt"
terraform <command>

export TF_LOG="DEBUG"
export TF_LOG_PATH="./citrix-provider-issue.txt"
terraform <command>

CitrixIssueId: 67979

[AlanCitrix]

Are you able to attach your .tf files with a minimum reproduction of the issue (and any secrets redacted)? The TF logs files could be helpful too, instructions on how to collect those are at the bottom of the issue body.

The error seems to have something to do with the .png, can you validate it exists and is accessible?

[vara-ti]

Many Thanks Alan, I see the same error when I am using the storefront onboarding script to which is at https://github.com/citrix/terraform-provider-citrix/blob/main/scripts/storefront-onboarding-helper/storefront-terraform-onboarding.ps1, that made me to think it seem to be a bug as its nothing much to do with my files. I will strip off any secrets etc and upload at some point.

[vara-ti]

Variable in module Variable.tf
variable "web_receiver_site_style" {
description = "Web receiver site styling"
type = object({
header_logo_path = string
logon_logo_path = string
header_background_color = string
header_foreground_color = string
link_color = string
})
}

module main.tf
web_receiver_site_style ={
header_logo_path = var.web_receiver_site_style.header_logo_path
logon_logo_path = var.web_receiver_site_style.logon_logo_path
header_background_color = var.web_receiver_site_style.header_background_color
header_foreground_color = var.web_receiver_site_style.header_foreground_color
link_color = var.web_receiver_site_style.link_color
}

root main.tf
locals {
web_receiver_site_style = {
header_logo_path = var.web_receiver_header_logo_path
logon_logo_path = var.web_receiver_logon_logo_path
header_background_color = var.web_receiver_header_background_color
header_foreground_color = var.web_receiver_header_foreground_color
link_color = var.web_receiver_link_color
}

}
module "webreceiver_service" {
source = "./modules/webreceiverservice"
depends_on = [module.store_service]
site_id = var.site_id
virtual_path = var.webreceiver_virtual_path
friendly_name = var.webreceiver_friendly_name
store_virtual_path = module.store_service.virtual_path
application_shortcuts = var.application_shortcuts
authentication_manager = var.authentication_manager
communication = var.communication
plugin_assistant = var.plugin_assistant
resources_service = var.resources_service
user_interface = var.user_interface
web_receiver_site_style = local.web_receiver_site_style
strict_transport_security_enabled = var.strict_transport_security_enabled
strict_transport_security_policy_duration = var.strict_transport_security_policy_duration

}

tfvars values

Logo Paths

web_receiver_header_logo_path = "C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\2x\CitrixStoreFrontReceiverLogo_Home@2x_B07AF017CEE39553.png"
web_receiver_logon_logo_path = "C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\2x\CitrixStoreFront_auth@2x_CB5D9D1BADB08AFF.png"

web_receiver_header_background_color = "#E7E7DD"
web_receiver_header_foreground_color = "#041459"
web_receiver_link_color = "#8AAFFA"
Part of successful plan related to webservicestyle

• web_receiver_site_style = {
  + header_background_color = "#E7E7DD"
  + header_foreground_color = "#041459"
  + header_logo_path = "C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\2x\CitrixStoreFrontReceiverLogo_Home@2x_B07AF017CEE39553.png"
  + link_color = "#8AAFFA"
  + logon_logo_path = "C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\2x\CitrixStoreFront_auth@2x_CB5D9D1BADB08AFF.png"
  }
  }

[vara-ti]

Sorry tried edit to add the error details from the debug file, not working so adding it here..
Error form debug file
2025-12-05T05:39:27.688-0500 [ERROR] provider.terraform-provider-citrix_v1.0.30.exe: Response contains error diagnostic:
diagnostic_detail=
| Error message: error executing command: Set-STFWebReceiverSiteStyle
| Error Message:
| C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\2x\CitrixStoreFrontReceiverLogo_Home@2x_B07AF017CEE39553.png\r
| + CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException\r
| + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException\r
| + PSComputerName : CHAPDA3CXUTL01.cloud.tiaa-cref.org\r
| \r
tf_req_id=bd696f0d-b64e-bdad-5b56-3251ba63449b tf_resource_type=citrix_stf_webreceiver_service @caller=github.com/hashicorp/terraform-plugin-go@v0.29.0/tfprotov6/internal/diag/diagnostics.go:58 diagnostic_severity=ERROR @module=sdk.proto diagnostic_summary="Error setting Site Style for the StoreFront WebReceiver" tf_proto_version=6.10 tf_provider_addr=registry.terraform.io/citrix/citrix tf_rpc=ApplyResourceChange timestamp=2025-12-05T05:39:27.688-0500
2025-12-05T05:39:27.695-0500 [ERROR] vertex "module.webreceiver_service.citrix_stf_webreceiver_service.this" error: Error setting Site Style for the StoreFront WebReceiver
2025-12-05T05:39:27.703-0500 [DEBUG] provider.stdio: received EOF, stopping recv loop: err="rpc error: code = Unavailable desc = error reading from server: EOF"
2025-12-05T05:39:27.729-0500 [DEBUG] provider: plugin process exited: path=.terraform/providers/registry.terraform.io/citrix/citrix/1.0.30/windows_amd64/terraform-provider-citrix_v1.0.30.exe pid=19604
2025-12-05T05:39:27.729-0500 [DEBUG] provider: plugin exited

[AlanCitrix]

Can you verify the file C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\2x\CitrixStoreFrontReceiverLogo_Home@2x_B07AF017CEE39553.png exists on the StoreFront server?

You can also try to reproduce this with the powershell SDK on the StoreFront machine by calling Set-STFWebReceiverSiteStyle manually. This would help us to understand if there is a configuration problem or a Terraform issue.

[vara-ti]

I have corrected my paths and its working with the default values as the png files coming with the configuration of the webservice. My organization uses custom logo and custom header files, when I give custom paths. i am getting the error.
Working Path :
web_receiver_header_logo_path = "C:\inetpub\wwwroot\Citrix\VDIWeb\receiver\images\2x\CitrixStoreFrontReceiverLogo_Home@2x_B07AF017CEE39553.png"
web_receiver_logon_logo_path = "C:\inetpub\wwwroot\Citrix\VDIWeb\receiver\images\2x\CitrixStoreFront_auth@2x_CB5D9D1BADB08AFF.png"

Not working :

web_receiver_header_logo_path = "C:\temp\Citrix_HalfHeaderLogo.png"
web_receiver_logon_logo_path = "C:\temp\Citrix_HalfLogonLogo.png"

Note: Copied the files to temp before the configuration.
The same worked with the Powershell..
Invoke-Command -Session $session -ScriptBlock {
$webReceiver = Get-STFWebReceiverService
$header_background_color = "#E7E7DD"
$header_foreground_color = "#041459"
$header_logo_path = "C:\temp\Citrix_HalfHeaderLogo.png"
$link_color = "#8AAFFA"
$logon_logo_path = "C:\temp\Citrix_HalfLogonLogo.png"
$webReceiver = Get-STFWebReceiverService
Set-STFWebReceiverSiteStyle -WebReceiverService $webReceiver -HeaderLogoPath $header_logo_path -LogonLogoPath $logon_logo_path -HeaderBackgroundColor $header_background_color -HeaderForegroundColor $header_foreground_color -LinkColor

[vara-ti]

Hey Alan, are you still checking this?

Many thanks!

[AlanCitrix]

Sorry and thank you for testing it out in PowerShell directly. This seems like a permission issue to me. Is the Terraform client running directly on the StoreFront server, or are you specifying a remote server? Does the ad_admin_username have permission to C:\temp and when you were running it manually were you logged in with the same user?

Another thing to try would be to move the files elsewhere, even into the C:\inetpub\wwwroot\Citrix\VDIWeb\receiver\images folder as we know that one is working.

Ultimately the Terraform provider is just running the PowerShell cmdlet using the specified user.

[vara-ti]

Many thanks Alan, for your reply! Here are my findings after testing as suggested.

Its working from C:\inetpub\wwwroot\Citrix\VDIWeb\receiver\images location because these are the default files, but my case is to use custom branding files for my organization.

We cant copy files before the webreceiver resource is not created as the folder C:\inetpub\wwwroot\Citrix\VDIWeb\receiver\images is not available.

I have done the copy of files to "C:\inetpub\wwwroot\Citrix\VDIUAT\App_Data\ just after store configuration is done with a null tf provider, and got the below error.

Error: Provider produced inconsistent result after apply
¦
¦ When applying changes to module.webreceiver_service.citrix_stf_webreceiver_service.this, provider "provider["registry.terraform.io/citrix/citrix"]" produced an unexpected new value:
¦ .web_receiver_site_style.header_logo_path: was cty.StringVal("C:\inetpub\wwwroot\Citrix\VDIUAT\App_Data\Citrix_HalfHeaderLogo.png"), but now
¦ cty.StringVal("C:\inetpub\wwwroot\Citrix\VDIUATWeb\custom\Citrix_HalfHeaderLogo.png").
¦
¦ This is a bug in the provider, which should be reported in the provider's own issue tracker.
?
?
¦ Error: Provider produced inconsistent result after apply
¦
¦ When applying changes to module.webreceiver_service.citrix_stf_webreceiver_service.this, provider "provider["registry.terraform.io/citrix/citrix"]" produced an unexpected new value:
¦ .web_receiver_site_style.logon_logo_path: was cty.StringVal("C:\inetpub\wwwroot\Citrix\VDIUAT\App_Data\Citrix_HalfLogonLogo.png"), but now
¦ cty.StringVal("C:\inetpub\wwwroot\Citrix\VDIUATWeb\custom\Citrix_HalfLogonLogo.png").
¦
¦ This is a bug in the provider, which should be reported in the provider's own issue tracker.

Note: The only its working for me is go with the default files and configure the web receiver and, then do the branding with PS through the TF itself.

[AlanCitrix]

Ok that error looks better than the one before as the previous issue was permission related. This looks like a provider bug, we will take this issue to fix the inconsistent result after apply.