2. Installing the files

The typical directory to install LiveJournal into is /home/lj, but it is not a requirement at all. To ease documentation, we'll assume that you'll want to install in that directory. We will also assume you'll be using user lj, but that also doesn't matter at all. Feel free to install wherever and as whoever … there shouldn't be any problems.

Prerequisite: $LJHOME Before you install, you should create the directory where your LiveJournal installation will reside. This needs to be the same directory that the environment variable $LJHOME is set to, otherwise your installation will not work properly. Consult Section 1, “$LJHOME Environment Variable” for information on setting $LJHOME.

Example 7.1. Creating the $LJHOME directory:

# mkdir /home/lj
# chown lj:lj /home/lj

Installing Subversion If you do not already have Subversion (SVN) on your system, you need to install it. If you are using Debian, the command to install it is:

apt-get install subversion

Using SVN

Bleeding edge releases of the code can be found in the SVN repository server: code.sixapart.com/svn/livejournal[o].


Installing and updating LiveJournal from SVN is not guaranteed to be stable.

Example 7.2. SVN Install:

$ cd $LJHOME
$ mkdir cvs
$ cd cvs
$ svn co http://code.sixapart.com/svn/vcv/trunk vcv
$ svn co http://code.sixapart.com/svn/livejournal/trunk livejournal
$ cd $LJHOME
$ cvs/vcv/bin/vcv --conf=cvs/livejournal/cvs/multicvs.conf --checkout -s

That last command will copy everything from the SVN directory over to $LJHOME, the live area.

Then in the future, to stay updated: $ bin/cvsreport.pl -u -c -s

The cvsreport.pl utility is just a front-end to the vcv tool. You can look at the vcv options to find out how to use it.

Having two copies of the code laying around may not make sense now, but it will later when we write the docs to explain how to run a heavily-customized version of the site and still stay up-to-date with the mainstream SVN.(FIXME: write/link that section)