How do I fix Redis TLS errors in .NET Aspire?

This skill provides a 5-point diagnostic to ensure your dev certificate is properly included in the system's CA bundle, which is a requirement for Redis TLS connections in Aspire 13.1.0+.

Why doesn't 'dotnet dev-certs https --trust' work on Linux?

On Linux, the command generates the certificate but fails to export it to the system CA directory or rebuild the consolidated CA bundle, leaving the OS and applications unable to verify the trust chain.

Does this skill support WSL2 environments?

Yes, it includes specific guidance for WSL2, addressing issues like shared filesystem permissions and ensuring the Linux kernel's separate certificate store is correctly updated.

Is a system reboot required after fixing the certificate?

No, a reboot is not required. You simply need to restart your .NET application so it can pick up the updated system CA bundle during its next TLS handshake.

.NET Dev Certificate Trust for Linux

Name: .NET Dev Certificate Trust for Linux
Author: Aaronontheweb

byAaronontheweb

•

491

•

Security & Testing

Diagnoses and resolves .NET HTTPS developer certificate trust issues across Ubuntu, Fedora, Arch Linux, and WSL2 environments.

This skill provides a comprehensive diagnostic and recovery framework for .NET developers facing HTTPS validation errors on Linux. While the standard .NET CLI fails to properly register certificates in the system trust store on non-Windows/macOS platforms, this skill bridges the gap by handling certificate export, permission management, and CA bundle reconstruction. It is particularly critical for developers using .NET Aspire 13.1.0 and later, where TLS is enabled by default for services like Redis, ensuring seamless inter-service communication and dashboard access without certificate chain errors.

Key Features

01Multi-distro support for Ubuntu, Debian, Fedora, RHEL, Arch, and WSL2

02Automated CA bundle rebuilding and symlink integrity checks

035-point diagnostic procedure to identify broken trust chains

04Full recovery scripts for clean-slate certificate regeneration and export

05491 GitHub stars

06Specialized troubleshooting for .NET Aspire Redis TLS and gRPC connectivity

Use Cases

01Restoring system-wide certificate trust after running 'dotnet dev-certs https --clean'

02Fixing 'UntrustedRoot' errors in .NET Aspire and Redis connections

03Setting up secure HTTPS development environments on Linux and WSL2

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aaronontheweb/dotnet-skills dotnet-devcert-trust

For use in Claude.ai and ChatGPT

Download Skill