Running on Linux and Mac

Today we're thrilled to announce that we've officially introduced support for running Newsletter Studio on Linux and MacOS. This means that we can now run on any platform where Umbraco runs.

What does this mean?

We have updated the code base and cleaned up inconsistent file/folder names to be able to run on the case-sensitive filesystem of Unix-like operating systems. The process has been quite an interesting challenge and in this blog post, we're sharing some of the findings and learnings from the project.

A big thank you to the Swedish digital agency Cloud9 for contributing to the work on this feature!

Breaking changes?

Yes and no. Technically there are breaking changes in the 12.1.0 release but this is only around the casing of filenames and folders which will not have any impact on installations running on Windows. Since this is the first version with support for Linux you should not have to make any changes if you want to continue running on Windows.

If you want to move an existing installation from Windows to Linux you'd need to adjust some folder names, please see the documentation for more details about this.

How to install?

To start running on Linux or Mac you need to be on the latest version of the package. We've released the initial version as a Release Candidate (RC) to gather some feedback but it should be in a very stable place so we expect the RC-period to be short.

Make sure you are running Umbraco 12 and install or upgrade to Newsletter Studio 12.1.0. Make sure to backup your data before upgrading.

dotnet add package NewsletterStudio --version 12.1.0

If you want to install from Visual Studio, make sure to check the "Include prereleases"-checkbox for the RC-version to show up.

More from the blog