WebFaction Software Documentation WebFaction is a service of Paragon Internet Group Limited CONTENTS 1 General Topics 3 1.1 Accessing Logs..............................................3 1.2 Monitoring Memory Usage.......................................4 1.3 Reducing Memory Usage........................................6 1.4 Setting File Permissions.........................................7 1.5 Scheduling Tasks with Cron.......................................9 1.6 Troubleshooting............................................. 10 2 Installing Software from Source 13 2.1 Troubleshooting............................................. 14 3 Bazaar 17 3.1 Installing Bazaar............................................. 17 3.2 Publishing Bazaar Repositories with Loggerhead............................ 17 4 Custom Applications 21 4.1 Creating a Custom Application..................................... 21 4.2 Automatically Restarting a Custom Application............................. 21 5 Django 23 5.1 Getting Started with Django....................................... 23 5.2 Configuring Django........................................... 28 5.3 Troubleshooting............................................. 35 6 Drupal 45 6.1 Backing Up Drupal............................................ 45 6.2 Updating Drupal............................................. 45 6.3 Configuring Clean URLs......................................... 46 6.4 Serving Uploads Faster.......................................... 47 6.5 Speeding Up Drupal with Caching.................................... 47 6.6 Sending Email from Drupal....................................... 48 6.7 Troubleshooting............................................. 48 7 Git 49 7.1 Installing the Git Web Application.................................... 49 7.2 Creating a New Repository........................................ 50 7.3 Cloning a Repository Hosted on Your WebFaction Server....................... 50 7.4 Enabling Anonymous Read Access................................... 51 7.5 Managing Users............................................. 51 7.6 Removing a Repository......................................... 52 7.7 Using HTTPS.............................................. 52 i 7.8 Troubleshooting............................................. 52 8 Gitea 55 8.1 Enable Public Registrations....................................... 55 8.2 Set Gitea to Production Mode...................................... 55 8.3 Edit First User’s Email Address..................................... 56 8.4 Configure Gitea to Send Email...................................... 56 8.5 Remove Public Keys After you have Deleted the App.......................... 56 8.6 Starting, Stopping, and Restarting Gitea................................. 57 9 Joomla 59 9.1 Upgrade Joomla............................................. 59 9.2 Sending Email.............................................. 59 10 Memcached 61 10.1 Setting Up Memcached......................................... 61 10.2 Using Memcached with an Application................................. 61 10.3 Shutting Down Memcached....................................... 61 11 Mercurial 63 11.1 Installing Mercurial........................................... 63 11.2 Publishing Mercurial Repositories to the Web.............................. 63 11.3 Troubleshooting............................................. 68 12 mod_wsgi 69 12.1 Reducing Application Start-Up Time.................................. 69 12.2 Reducing mod_wsgi Memory Consumption............................... 69 12.3 Using a virtual environment with mod_wsgi.............................. 70 13 MongoDB 73 13.1 Installing MongoDB........................................... 73 14 Movable Type 75 14.1 Configuring Movable Type to Send Mail................................ 75 14.2 Configuring Movable Type to Send Email with SMTP......................... 76 15 Node.js 79 15.1 Starting and Stopping Node.js...................................... 79 15.2 Installing Packages with npm ...................................... 79 15.3 Upgrading Node.js............................................ 80 16 Perl 81 16.1 Installing cpanminus........................................... 81 16.2 Installing a Perl Module with cpanm .................................. 81 16.3 Using Local Perl Modules in a Command-Line Script......................... 81 16.4 Using Local Perl Modules in a CGI Script................................ 82 16.5 Using Alternate Perl Versions with Perlbrew.............................. 82 17 PHP 85 17.1 PHP on the Command Line....................................... 85 17.2 Configuring PHP............................................. 85 17.3 Upgrade to another PHP version..................................... 86 17.4 Configuring an Upload Limit...................................... 86 17.5 Configuring DOCUMENT_ROOT ..................................... 87 17.6 Using FastCGI.............................................. 88 17.7 Installing a Custom PHP Package.................................... 88 ii 17.8 Installing and Using PEAR Packages.................................. 89 17.9 Serving HTML Files as PHP Scripts................................... 90 17.10 Sending Mail from a PHP Script..................................... 90 17.11 Serving an Application from a Subdirectory............................... 91 17.12 Setting PHP’s Default Time Zone.................................... 91 17.13 Troubleshooting............................................. 92 18 Private Database Instances 93 18.1 Private MySQL Instances........................................ 93 18.2 Private PostgreSQL Instances...................................... 96 18.3 Configuring Applications for Private Database Instances........................ 99 19 Pyramid 103 19.1 Deploying an Existing Pyramid Project................................. 103 19.2 Serving Pyramid with a URL Prefix................................... 104 19.3 Starting, Stopping, and Restarting Pyramid............................... 104 20 Python 107 20.1 Python Search Path............................................ 107 20.2 Creating a python Alias........................................ 108 20.3 Installing Python Packages........................................ 108 20.4 Troubleshooting............................................. 110 21 Ruby 115 21.1 Installing Gems.............................................. 115 22 Ruby on Rails 117 22.1 Installing Ruby on Rails......................................... 117 22.2 Upgrading RubyGems.......................................... 118 22.3 Installing Gems.............................................. 118 22.4 Installing Multiple Gems with Bundler................................. 119 22.5 Installing ImageMagick and RMagick.................................. 119 22.6 Installing sqlite3-ruby .......................................... 120 22.7 Deploying a Ruby on Rails Application................................. 121 22.8 Deploying a Ruby on Rails Application with Capistrano........................ 121 22.9 Upgrading Ruby on Rails........................................ 122 22.10 Using a Database with a Ruby on Rails Application.......................... 123 22.11 Configuring Action Mailer........................................ 124 22.12 Troubleshooting............................................. 125 23 Redmine 127 23.1 Configuring Redmine to Send Email................................... 127 24 SQLite 129 24.1 Installing SQLite............................................. 129 24.2 Installing SQLite from Source...................................... 129 25 Static Files, CGI Scripts, and PHP Pages 131 25.1 Static-only................................................ 131 25.2 Static/CGI/PHP.............................................. 132 25.3 Troubleshooting............................................. 138 26 Subversion 143 26.1 Send Email Notifications with a Post-Commit Hook.......................... 143 26.2 Managing Users............................................. 144 iii 26.3 Reusing Usernames and Passwords Between Subversion and Trac................... 145 26.4 Backing Up and Restoring Subversion Repositories........................... 145 27 Trac 147 27.1 Getting Started with Trac........................................ 147 27.2 Enabling Email Notifications...................................... 149 27.3 Enabling reStructuredText........................................ 149 27.4 Managing Users............................................. 150 27.5 Disable .htpasswd Authentication.................................. 150 27.6 Changing the Git Repository Path.................................... 151 27.7 Setting a Logo.............................................. 151 27.8 Setting Trac’s Default Time Zone.................................... 152 27.9 Upgrade a Trac Application....................................... 152 28 WebDAV 155 28.1 Creating a WebDAV Application.................................... 155 28.2 Adding and Removing WebDAV Users................................. 156 29 Webstats 159 29.1 AWStats................................................. 159 29.2 Webalizer................................................. 159 30 WordPress 161 30.1 Using WordPress............................................. 161 30.2 Advanced WordPress........................................... 165 30.3 Troubleshooting WordPress....................................... 168 Index 171 iv WebFaction Software Documentation Contents: CONTENTS 1 WebFaction Software Documentation 2 CONTENTS CHAPTER ONE GENERAL TOPICS