How to install Cosmos

Important Notes

  • If you have previously installed a user kit, please uninstall it first. See [Older releases](https://github.com/CosmosOS/Cosmos/wiki/Older releases/)
  • Visual Studio 2015 and older are no longer supported.
  • Because of the system requirements of Visual Studio 2017, Vista and older are not supported.

Difficulty: Easy

Introduction

What is the User Kit?

The User Kit is what you want to download if you begin with Cosmos and don’t want to make changes to Cosmos core. It contains all the required project files for creating an OS and is regularly updated. Latest version is 20170612. It’s in fact the installer version of one devkit version.

What is the Dev Kit?

The Dev Kit (for Development Kit) is the thing to use if you want/need to make changes to Cosmos internals. It’s in fact the source code of Cosmos.

Pre-requisite Software

User Kit and Dev Kit

  • Visual Studio 2017 Download
  • Visual Studio 2017 Workload: .NET Core Tools
  • .NET Framework 4.6.2 (Separate download for Windows 8.1 and older) Download

Devkit only

  • Visual Studio 2017 Workload: Visual Studio Extension Development
  • Inno Quick Start Pack (Free) – Install with defaults, keep Preprocessor option checked Download

 

Installing Cosmos

Userkit
  1. Download the latest release of Cosmos (download the exe file)
  2. Wait for the download to complete then run the installer. Allow it to run as admin. Make sure VS2017 is NOT running when you do this.
  3. Click “Next” then “Install”
  4. Wait for the install to progress. (Tip: At the end the installer may look like it is stalling, it is still doing something, just in the background)
  5. When finished it will very obviously say it has finished and have a “Finish” button – click the “Finish” button.
  6. Cosmos should now be installed. Follow other tutorials to find out how to create your first OS.
Dev Kit

1. Getting the source

Downloads

Once you have all the prerequisites, you may download the source using one of the following methods:

File Type Stable Dev
.zip v2017-06-12 Latest-zip
.tar.gz v2017-06-12 Latest-tar
git clone Clone (see for Dev) and then
git reset --hard 354e913
git clone https://github.com/CosmosOS/Cosmos.git
Github for Windows N/A Open in app

2. Building and installing

(if you have already installed) If you edited the Cosmos DevKit source using Cosmos.sln, be sure to set solution config to Debug x86.

  1. Make sure Visual Studio is NOT running.
  2. In the root directory of the DevKit files, you downloaded earlier, run install-VS2017.bat.
  3. Wait for the install to progress. (Tip: At the end the installer may look like it is stalling, it is still doing something, just in the background)
  4. VS will open with Cosmos loaded. You can now make changes to core assemblies of Cosmos. If you don’t want to, you can close this VS window and create a new Cosmos project as with the user kit.