Running

Not logged in - Log In / Register

Revision 8 as of 2009-08-03 15:46:14

Clear message

This page tells you how to build and run Launchpad on your own machine. Ask for help right away if you run into problems.

Note: Launchpad does not work on Karmic yet! There is currently a hard dependency on python2.4, but we aim to fix this before Karmic is released. Launchpad developers are currently using Jaunty. If you wish to live on the bleeding edge, there are some initial notes at LaunchpadOnKarmic, but do not expect this to be fully working yet.

Building

Assuming you have already gotten the Launchpad source code, here's how to build a pristine trunk (devel) instance. First, be in the top level of the source code:

  $ cd devel

Before you can run Launchpad for the first time, you need to set up Postgres.

WARNING!

DO NOT run the database setup script below if you use Postgres for anything other than Launchpad! Running the script will destroy any Postgres databases on your system. (see DatabaseSetup for more)

  $ ./utilities/launchpad-database-setup $USER

(Please have read the previous comment before you run the above command!)

Finally, build the database schema:

  $ make schema

Running

Now you should be able to start up Launchpad:

  $ make run

For subsequent builds, you can just do make run right away. You don't need to do make schema every time, and you should avoid it because it's expensive and because it will clean out any data you might have put into your test instance (through the web UI or by running other scripts).

Now try logging into your locally-running Launchpad, using the default username and password:

  username: admin@canonical.com
  password: test

Stopping

You can stop Launchpad by doing a Control-C in the terminal where you started it:

  ^C
  [...shutting down Launchpad...]
  $ 

Or you can be at a prompt in the same directory and run this:

  $ make stop