Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
90 lines (60 sloc) 2.49 KB

Installation

Note

Installing Mozillians might be daunting. Ask for help in #mozillians on irc.mozilla.org. tofumatt, timw, or tallOwen will be happy to help.

You'll need ruby, vagrant, Virtualbox and git. The following steps will help you:

  1. Install vagrant (requires ruby):

    $ gem install vagrant
    

    Note

    you don't need to install the lucid32 box, one will be installed automatically with mozillians)

  2. Install virtualbox by Oracle.

    Note

    If you run Linux, you'll need to make sure virtualization isn't disabled in your kernel.

  1. Get a copy of Mozillians.org:

    $ git clone --recursive git://github.com/mozilla/mozillians.git mozillians
    $ cd mozillians
    
  2. Run a virtual dev environment:

    $ vagrant up
    $ vagrant ssh # you will now enter the virtualized environment
    

    Note

    Run this in your working copy directory (i.e. mozillians/)

    You can edit files under (mozillians/) locally and they will automatically show up under /home/vagrant/mozillians in the virtualbox. This means you can edit in your favorite text-editor, yet run Mozillians from our virtualized environment.

  3. Setup the database::

    $ ./manage.py update_product_details -f $ mysql -u root > create database mozilians; > exit; $ ./manage.py syncdb --noinput $ ./manage.py migrate

  4. Run the development web server (in the virtualized environment):

    $ ./manage.py runserver 0.0.0.0:8000
    

Note

rs is one of the many handy Django aliases included in the Mozillians VM. It's aliases to ./manage.py runserver 0.0.0.0:8000. You can see all the aliases available by typing alias inside your VM shell or by inspecting the contents of puppet/files/home/vagrant/zshrc (or bashrc_vagrant if you use bash).

  1. Point your web browser to http://localhost:8000

  2. Stay up-to-date:

    On your host machine do:

    $ git pull -q origin master
    $ git submodule update --recursive
    $ pushd vendor
    $ git pull -q origin master
    $ git submodule update --recursive
    $ popd
    

    Then you can run any needed database migrations inside your VM:

    $ dj syncdb
    $ dj migrate
    

    Occassionally there will be a new base VM box. If so, get it with:

    $ vagrant destroy
    $ vagrant up
    
Jump to Line
Something went wrong with that request. Please try again.