diff options
| author | Lee Coward <leecow@microsoft.com> | 2019-01-24 01:59:01 +0300 |
|---|---|---|
| committer | Lee Coward <leecow@microsoft.com> | 2019-01-24 01:59:01 +0300 |
| commit | ebceec148ae29f1648d4b26b7e6d7175d9edd076 (patch) | |
| tree | 76a4d40629b0c52027f1676b8bc1a70fbf9b8856 /Documentation/linux-setup.md | |
| parent | 5ff3d374137c30b5fffb56dbd7ab1cbe4458b2ce (diff) | |
add ssl cert to snap instructions
Diffstat (limited to 'Documentation/linux-setup.md')
| -rw-r--r-- | Documentation/linux-setup.md | 30 |
1 files changed, 28 insertions, 2 deletions
diff --git a/Documentation/linux-setup.md b/Documentation/linux-setup.md index 852f76d2..51df6a1a 100644 --- a/Documentation/linux-setup.md +++ b/Documentation/linux-setup.md @@ -102,7 +102,33 @@ We have been working on bringing .NET Core to Snap and are ready to hear what yo * As with our other installers, the Runtime and SDK are available depending on your needs. The SDK installation will include the .NET Core runtime and ASP.NET Core runtime. ```bash -sudo snap install dotnet-sdk --candidate --classic +sudo snap install dotnet-sdk --classic ## or -sudo snap install dotnet-runtime-21 --candidate +sudo snap install dotnet-runtime-21 --classic ``` + +### SSL Certificate resolution with Snap installs + +On some distros, a few environment variables need to be set in order for .NET Core to properly find the SSL certificate. You will know this is needed on your system if you get an error similar to the following during `restore`. + +```bash +Processing post-creation actions... +Running 'dotnet restore' on /home/myhome/test/test.csproj... + Restoring packages for /home/myhome/test/test.csproj... +/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : Unable to load the service index for source https://api.nuget.org/v3/index.json. [/home/myhome/test/test.csproj] +/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : The SSL connection could not be established, see inner exception. [/home/myhome/test/test.csproj] +/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : The remote certificate is invalid according to the validation procedure. [/home/myhome/test/test.csproj] +``` + +To resolve this issue + +```bash +export SSL_CERT_FILE=[certificate file location and name] +export SSL_CERT_DIR=/dev/null +``` + +The certificate location will vary by distro. Here are the locations for the distros where we have experienced the issue. + +* Fedora - `/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem` +* OpenSUSE - `/etc/ssl/ca-bundle.pem` +* Solus - `/etc/ssl/certs/ca-certificates.crt`
\ No newline at end of file |