OpenTechSchhol website is build with the help of Jekill which has some requirements to make it run. If you have GNU/Linux, Unix, or macOS the installation and you met all the requirements listed to the next point, install the OTS website should be straight-forward. If you have Windows then you will have to do some twist. Please follow the official Jekill documentation.

If you encounter any issues that isn't documented here, feel free to submit a PR and share your solution with us.

To run the website you need to have Ruby installed on your machine. If you don't have it, please check the official documentation

Then you need to install:

• RubyGems
• GCC and Make (in case your system doesn’t have them installed, which you can check by running gcc -v and make -v in your system’s command line interface)
• Install ruby version manager: rvm, rbenv
• Install bundle gem install bundler

Official Jekyll documentation

• clone or fork
  (if you don't know how to work with github, we suggest you to take a look at our github material before start)
• enter into project folder cd website-relaunch
• bundle install (if you don't have bundler on your computer, please install it before run this command)
• build and run the website with jekyll serve
• open a browser and go to http://localhost:4000/

In general is a good idea to read carefully what the error/warning message say in the console.
Most of the time just following what the message say, can fix the problem.

if you get a warning message after running bundle install like:

Warning: the running version of Bundler is older than the version that created the lockfile. We suggest you upgrade to the latest version of Bundler by running `gem install bundler`. run gem install bundler.

If after running bundle install you get an error like:

There is a chance you are experiencing a man-in-the-middle attack, but most likely your system doesn't have the CA certificates needed for verification. For information about OpenSSL certificates, see bit.ly/ruby-ssl. To connect without using SSL, edit your Gemfile sources and change 'https' to ‘http' ``` it means your computer has some issue with the OpenSSL certificates. Is also possible that in other project you find no problem to install bundler but here there are. Here you will need some googoling since the solution is different from System Operator and version of your OS. OS Sierra > 10.00 which make use of [rvm](https://rvm.io/), this command should do the trick: `rvm osx-ssl-certs update` It will ask to put your admin password, be sure to have it ready. ### Different Ruby version required to install package XXX if after running `bundle install` you will get an error like: ```Error installing XXX: XXX requires Ruby version >= 2.2.2``` you will need to install that version of Ruby. To do so you need some kind of version management tool. A common one is [rvm](https://rvm.io/) otherwise another popular one is [rbenv](https://github.com/rbenv/rbenv) To install Ruby to last stable version with rvm just run `rvm get stable`. Still having trouble? Ask us in [gitter](https://gitter.im/OpenTechSchool/www.opentechschool.org)