Diff for "Running"

Not logged in - Log In / Register

Differences between revisions 31 and 32
Revision 31 as of 2010-11-16 19:37:53
Size: 3402
Editor: maxb
Comment:
Revision 32 as of 2011-06-21 23:16:38
Size: 3486
Editor: lifeless
Comment: we run on lucid
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
'''Building and running Launchpad requires a computer running [[http://www.ubuntu.com/|Ubuntu]]. Furthermore, it must be Ubuntu Lucid or Maverick.''' '''Building and running Launchpad requires a computer running [[http://www.ubuntu.com/|Ubuntu]]. The production launchpad.net site runs on Ubuntu Lucid. Other versions may work to run Launchpad locally, but no guarantees are made.'''

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

System Requirements

Building and running Launchpad requires a computer running Ubuntu. The production launchpad.net site runs on Ubuntu Lucid. Other versions may work to run Launchpad locally, but no guarantees are made.

You might choose to use an installation of one of these Ubuntu versions within a chroot or in a virtual machine, if your main system is not suitable.

We'd like Launchpad to run on other operating systems, especially Debian GNU/Linux, so that more people can contribute to Launchpad development. If you're interested in working on Launchpad portability, please let us know. Note that our focus is on getting Launchpad to build easily so more people can participate in Launchpad development. Running a stable production instance would be much harder than running a single-developer test instance, and we don't recommend it. Unlike many open source projects, we're not seeking to maximize the number of installations; our goal is to improve the instance we're already running at Launchpad.net.

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 advanced running see Advanced running of Launchpad

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).

Open up your local webbrowser and go to

http://launchpad.dev

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

Subpage Index

Running (last edited 2022-04-29 18:53:15 by jugmac00)