How to install Cosmos
- If you have previously installed a user kit, please uninstall it first. See 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.
The UserKit 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 20150918. It's in fact the installer version of one devkit version.
The DevKit (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. It contains the Userkit installer.
UserKit and DevKit
- Visual Studio 2017 (Community edition is supported) Download
- Visual Studio 2017 Workload: .NET Core Tools
- .NET Framework 4.6.2
- VMWare Player (Free) Download or Workstation Download.
DevKit only
- Visual Studio 2017 Workload: Visual Studio Extension Development
- Inno Quick Start Pack (with preprocessor) Download
- Download the latest release of Cosmos (download the exe file)
- 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.
- Make sure VMWare isn't running.
- Make sure you aren't about to do a Windows Update restart or something similarly stupid...
- Click "Next" then "Install"
- (if you fail this step you should give up now...)
- 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)
- When finished it will very obviously say it has finished and have a "Finish" button - click the "Finish" button.
- Cosmos should now be installed. Follow other tutorials to find out how to create your first OS.
Once you have all the prerequisites, you may download the source using one of the following methods:
| File Type | Stable | Dev |
|---|---|---|
| .zip | v2015-09-18 | Latest-zip |
| .tar.gz | v2015-09-18 | Latest-tar |
| git clone | Clone (see for Dev) and thengit reset --hard d382572
|
git clone https://github.com/CosmosOS/Cosmos.git |
| Github for Windows | N/A | Open in app |
(if you have already installed) If you edited the Cosmos DevKit source using Cosmos.sln, be sure to set solution config to Debug x86.
- Make sure Visual Studio is NOT running.
- In the root directory of the DevKit files, you downloaded earlier, run
install-VS2017.bat. - 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)
- 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.