From Sudo Room
Jump to navigation Jump to search

How to set up a local instance of a sudo mesh sites, namely website

Debian / Ubuntu / General? Linux

  • Install LAMP server which is a common software stack of Linux with Apache, MySQL, and PHP (but also can refer to Perl/Python).
    $ sudo apt-get install tasksel
    • Select the "LAMP server" option with the space bar, then press enter or select the "OK" button.
    or, possibly use:
    $ sudo apt-get install lamp-server
    if that doesn't work, try installing lamp via the following:
    $ sudo apt-get install apache2
    Then install PHP:
    $ sudo apt-get install php5 libapache2-mod-php5
  • Examine how Apache runs, can be managed as a service to "reload" or "restart", and how it works with PHP.
    • For most of this, having a full LAMP install saves a bit of configuration time to get running.
    • Apache site config file: for /etc/apache2/sites-available/peoplesopen.loc
      $ sudo nano /etc/apache2/sites-available/peoplesopen.loc.conf
        • For some reason, modern Ubuntu needs the ".conf" on the end--it shouldn't really matter, but it's convenient.
    • Create the directories for your site
      $ sudo mkdir /var/www/peoplesopen.loc/public_html -p
    • Need to enable site with:
      $ sudo service apache2 restart
      $ sudo a2ensite peoplesopen.loc
      • You may need to
  • Edit /etc/hosts file to include something like this line (unless you have a specific configuration): peoplesopen.loc
    • If you happen to be using a local dns caching system, you may need clear it with something like:
      $ sudo service nscd restart
    • Now visit http://peoplesopen.loc in your browser
  • Install WordPress (it's easy!)
    • Grab a copy of latest wordpress:
      $ cd /var/www/peoplesopen.loc
      $ wget
      $ unzip
      $ mv wordpress/* public_html/
      $ rm -r wordpress/
    • Change owners (this lets the Apache users, who goes by www-data on debian/ubuntu own the files and write to them, but you can too as the group owner)
      $ sudo chown www-data:YOURUSERNAME ./ -R
      $ sudo chmod g+w ./ -R
    • Create a MySQL database.
      $ mysql -u root -p
      mysql> create database peoplesopen;
      mysql> show databases;
      mysql> quit;
    • Browse to http://peoplesopen.loc to proceed with the installation process, filling out with the information from the previous steps.
      • Fill out the basic site information (doesn't really matter, use whatever is helpful), including a local user account. Don't forget the password, it'll be easier not to.
    • Once you've finished and logged in to this new local site, we need to install the themes, including making a clone of the github repository of the peoplesopen "child theme" to your local machine.
      $ cd /var/www/peoplesopen.loc/wp-content/themes/
      $ wget
      $ unzip
      $ git clone
      • If you don't have git installed, install it this way:
        $ sudo apt-get install git
    • Finally, since the "child theme" specifies some custom colors, we need to save them so they show up:

Mac OSX Flavas..

So, the big difference between going the MAMP route and installing on Linux, is that on MAMP your local dev environment is not in $ /var/www but instead in $ /Applications/htdocs

1. Install MAMP: Note: Just download the free version, the pro automatically comes bundled with it.

2. Download WordPress:

3. move it from your Downloads folder and put it here: $ /Applications/MAMP/htdocs $ unzip [Your WP zip file]

4. You're going to need to do some minor configuration:

 - Build a database on phpMyAdmin
 - Create users, etc
 - If you've never installed WP, read this:
 -Once WP is installed and ready to go, then proceed to the next step

5. Get the conf file Now that you know where things are, go get the Apache conf file from here:

Save it as peoplesopen.loc.conf and put is here: $ /Applications/MAMP/conf

6. Now, go download the 'wp-foundation' theme and move it to your 'themes' folder

themes folder is located at $ /Applications/MAMP/htdocs/peoplesopen/wordpress/wp-content/themes

7. Next, clone the People's Open theme and put it in your 'themes' folder: go to your themes folder and type: $ git clone

Note: PeoplesOpen theme is built on top of the WP-Foundation theme

8. Now that you have all the necessary files, log into your wp-damin GUI and activate the PeoplesOpen theme. And voila! You're done ;)