Installing .NET Core on Mac OS X

I have bought a MacBook lately and wanted to learn how to work with .NET Core. The first thing is installing the .NET Core libraries and tools of course, which is available from:

.NET Core requires OpenSSL 1.0.0 or later, but Mac OS X currently defaults to OpenSSL 0.9.8. So we first download the sources for the latest stable OpenSSL release 1.0.2h:

Next unpack the OpenSSL Sources:

tar xzf openssl-1.0.2h.tar

Then compile and install OpenSSL to /usr/local/ssl/macos-x86_64:

./Configure darwin64-x86_64-cc shared enable-ec_nistp_64_gcc_128 no-ssl2 no-ssl3 no-comp --openssldir=/usr/local/ssl/macos-x86_64
make depend
sudo make install

Next we need to create symbolic links for the OpenSSL binaries and libraries in the /usr/local directory, or the .NET Core tools won't find them.

sudo ln -s /usr/local/ssl/macos-x86_64/bin/openssl /usr/local/bin/openssl
sudo ln -s /usr/local/ssl/macos-x86_64/lib/libssl.1.0.0.dylib /usr/local/lib/libssl.1.0.0.dylib
sudo ln -s /usr/local/ssl/macos-x86_64/lib/libcrypto.1.0.0.dylib /usr/local/lib/libcrypto.1.0.0.dylib

And that's it.

You can now start with .NET Core.

mkdir DotNetCoreSample
cd DotNetCoreSample
dotnet new

How to contribute

One of the easiest ways to contribute is to participate in discussions. You can also contribute by submitting pull requests.

General feedback and discussions?

Do you have questions or feedback on this article? Please create an issue on the GitHub issue tracker.

Something is wrong or missing?

There may be something wrong or missing in this article. If you want to help fixing it, then please make a Pull Request to this file on GitHub.