Welcome to Katana
Katana is a flexible set of components for building and hosting OWIN-based web applications.
This site is the home for Katana host, server, and middleware source code and documentation. Official releases of Katana components (including prerelease versions) can be found on http://nuget.org
. For Katana developer tools, such as Visual Studio project templates, visit the Downloads
page on this site.
These products are actively developed by the Katana team assigned to the Microsoft Open Tech Hub and in collaboration with a community of open source developers. Together we are dedicated to creating the best possible platform for Web application hosting and development.
You can browse the source code via the web
or use git
to clone the source repository.
git clone https://git01.codeplex.com/katanaproject
To build and run the tests from a command prompt, run build.cmd (found in the root directory). Note: As part of building you may need to obtain NuGet packages from the Outercurve Foundation NuGet public feed*.
*By running build, you will be initiating the download of other software packages from a NuGet-based feed that is owned by the Outercurve Foundation. You are responsible for locating, reading and complying with the license terms that accompany each such package. Each package is licensed to you by its owner. Microsoft is not responsible for, nor does it grant any licenses to, third-party packages.
See Katana.sln in the root directory to open the solution in Visual Studio.
Signed Nightly Builds
If you do not want to build the source, nightly builds are available via a private NuGet feed. Nightly builds are meant for developers to try out new features or bug fixes ahead of an official prerelease or final build. We strongly urge you to only use official builds for production.
Nightly builds can be used with Visual Studio 2010 SP1 or Visual Studio 2012. To use the nightly build:
- In your Package Manager settings add the following package source: http://www.myget.org/f/katana/
- Add or update to the latest build of Katana.
The Downloads tab hosts a zip file that contains Visual Studio developer tooling to help you more quickly get started with building Katana applications. At present, the tooling consists of 2 components:
- Katana.vsix – installs Visual Studio project templates for Katana Web Applications and Katana Console Applications.
- Katana hosting – enables an F5 experience in Visual Studio for running and debugging OWIN applications using Katana.exe. This is accomplished by installing an alternate "Visual Studio Development Server" using Katana.WebDev.WebServer40.exe.
There are lots of ways to contribute
to the project, and we appreciate our contributors.
You can contribute by reviewing and sending feedback on code commits, suggesting and trying out new features as they are implemented, submit bugs and help us verify fixes as they are checked in, as well as submit code fixes or code contributions of your own. Note that all code submissions will be rigorously reviewed and tested by the Katana team, and only those that meet an extremely high bar for both quality and design/roadmap appropriateness will be merged into the source.
We recently released the Microsoft.Owin.Host.SystemWeb 1.0.0 component and are currently working on the next comprehensive release. For details on our planned features and future direction, please refer to our roadmap