# Where can I find a complete tutorial for Windows? Trellis + Sage

**URL:** https://discourse.roots.io/t/where-can-i-find-a-complete-tutorial-for-windows-trellis-sage/7049
**Category:** general
**Created:** 2016-06-23T23:06:43Z
**Posts:** 14
**Showing post:** 3 of 14

## Post 3 by @QWp6t — 2016-06-24T00:20:58Z

> [@webmaster](#):
>
> The docs on this page suck - [https://roots.io/trellis/docs/windows/](https://roots.io/trellis/docs/windows/)

PRs accepted. :middle_finger:

# A Windows User’s Quick Guide to Using Roots Stack

## Requirements

- [VirtualBox](https://www.virtualbox.org/wiki/Downloads) `>=` 5.0.10
- [Vagrant](https://www.vagrantup.com/) `>=` 1.8.0
- Vagrant plugins
- `vagrant plugin install vagrant-hostmanager`
- [NodeJS](http://nodejs.org/) `>=` 0.12.0
- [Gulp](https://github.com/gulpjs/gulp/blob/master/docs/getting-started.md) and [Bower](https://github.com/bower/bower/blob/master/README.md#install)
- `npm i -g gulp bower`

While not required, I would also recommend installing the full version of [cmder](http://cmder.net/). It will come with `git`, `ssh`, and many other binaries and aliases that are needed to get shit done.

# Development Environment

(Poached from [roots-example-project.com/readme.md](https://github.com/roots/roots-example-project.com#local-development-setup))

1. **Clone this repository** into a working directory (e.g., `%userprofile%\Sites`)

```
$ git clone git@github.com:roots/roots-example-project.com.git
```

1. **Install theme components**

```
# @ roots-example-project.com/site/web/app/themes/sage
$ npm install
$ bower install
$ gulp
```

1. **Fire up the server** (be patient, but watch the console––it may prompt for your system password)

```
# @ roots-example-project.com/trellis
$ vagrant up
```

```
_Note: to shut down the server:_ `vagrant halt`
```

1. **Test the install** at [roots-example-project.dev](http://roots-example-project.dev/)

## Fin.

Following those steps on a new installation of Windows 7-10 should yield you a working copy of [roots-example-project.com](http://roots-example-project.com). You can tinker with it and modify its configuration as needed to suit your needs. You can also [follow the instructions in the project’s repo](https://github.com/roots/roots-example-project.com/blob/master/README.md#instructions) on how to manually compile the stack by yourself.

---

_[View the full topic](https://discourse.roots.io/t/where-can-i-find-a-complete-tutorial-for-windows-trellis-sage/7049)._