-
Notifications
You must be signed in to change notification settings - Fork 0
[English] How to install and run Catarse
Ok, there are a few (but small) steps to run catarse on your machine, even if it is a Windows-based one.
NOTE: This will take some minutes to go depending on your configurations. The whole process can take more than 10 minutes if your connection is slow. But, for your happiness, this only happens on the first run. After that, everything will be amazingly fast.
-
You have to download Vagrant for your specific system.
-
For instance, I'm a mac user, so I have to download the Vagrant.dmg file on the list. If you're a Windows user, you have to choose the Vagrant.msi and so on. Every download has its own OS symbol on the left.
-
The link to download is here: http://downloads.vagrantup.com/
-
The first on the list is the more recent version
- Open the download
- Just go "Next" for all steps
- You'll asked to enter your password or administrator privileges.
-
VirtualBox is a tool to manage and create Virtual Machines (like I said, you can run other "machines" inside yours).
-
You need to download for your specific Operational System. For instance, "OS X host" on the downloads list means Mac OS X, "Windows Hosts" means Microsoft Windows and "Linux Hosts" means Ubuntu, Debian and so on.
-
Download it here: https://www.virtualbox.org/wiki/Downloads
- Open the download
- Just go "Next" for all steps
- Probably the installation will require administrator privileges, so if asked to type your password, you can trust.
- Open the "terminal" application.
- Go to spotlight and search for "terminal". Open it.
-
You'll have to download the putty application, which will install a terminal-like app in your machine. Link for download is here: http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe
-
Download and install mysysgit from: http://code.google.com/p/msysgit/downloads/list This is needed so that Windows has git capablity.
-
In Git Setup you need to choose the following options:
- On “Adjusting your PATH environment” dialog choose “Run Git from the Windows Command Prompt”. - On “Choosing the SSH executable” dialog choose “Use OpenSSH”. - IMPORTANT: On “Configuring the line ending conversions” dialog choose “Checkout as-is, commit Unix-style line ending”. -
Restart your computer (Yeah, I know. It sucks)
-
Open the command prompt (Go to "Run" and then Type "cmd"). In Windows 8 you have to open the Start Menu and Type "R" (this will open the "Run" box)
-
Clone the repository. Type this:
git clone https://github.com/danielweinmann/catarse -
Type
cd catarse/to enter the directory that was just created. -
This is a complicated step, here is some blog posts to help you achieve this: http://www.seascapewebdesign.com/blog/part-1-getting-started-vagrant-windows-7-pc and http://zamboni.readthedocs.org/en/latest/topics/install-zamboni/vagrant-on-windows.html (ignore the steps for Zamboni)
- Inside the
catarse/directory, typevagrant gem install librarian - Type
vagrant gem install vagrant-vbguestto keep the VM shared connection updated - After the successful installation of these gems, type
vagrant up - This command will download a virtual machine and install some essential packages.
- Type
vagrant provisionto install some tools to help you run Catarse's code.
- Open your favorite web browser and go to
http://localhost:3000. Voalá. Catarse is running.
-
Open your favorite editor or IDE, make modifications and commit it to your own server. Any modifications you do on your machine is reproduced on the Virtual one. Just edit your local files.
-
If you need to run tests or others, run
vagrant sshand thencd vagrant/to enter the Catarse directory on the Virtual Machine. -
On windows you'll need Putty for this.
- There are other wikis to help you commit to your server or just make a pull request.
- Go to "Wiki" link above and go for a ride.