about

documentation for developers

downloads

powered by

^*coming soon

home :: documentation :: users :: install :: dynamic :: macosx_install.txt

Install Blosxom on your Mac by Hand

1. Before you can get down to the nitty gritties, you'll need a fresh copy of Blosxom in hand. Download it here. Stuffit Expander should kick into gear and take care of unZIPping the archive for you, leaving a copy of blosxom.cgi sitting on your Desktop.
2. The on-board Apache Web server is rather picky about where it allows CGI scripts to live. Drop blosxom.cgi into its special CGI directory, /Library/WebServer/CGI-Executables.

3. You'll need to bless blosxom.cgi (make it "executable") so that your Web server will be allowed to run it. Do so by launching the Terminal (/Applications/Utilities/Terminal) app to get to the command-line and typing:

   chmod 755 /Library/WebServer/CGI-Executables/blosxom.cgi

4. All of Blosxom's blog entries live in a special folder. As good a place as any to keep these posts is in the Apache Web server's Web page repository, /Library/WebServer/Documents. Create a Folder within by typing the following at the Terminal's command-line:

   sudo mkdir /Library/WebServer/Documents/blosxom

   You'll be prompted for your password as /Library/WebServer/Documents isn't a folder you're usually allowed to write to.

   You'll also want to permit yourself to write to your newly-created blosxom folder whenever you wish, without need of a password. On the command-line, type:

   sudo chgrp staff /Library/WebServer/Documents/blosxom
   sudo chmod 775 /Library/WebServer/Documents/blosxom

   Quit the Terminal application (Command-Q or Terminal > Quit Terminal).

5. Your built-in Apache Web server will need to be running before you can visit your Blosxom blog. To turn it on--if it's not already so--launch System Preferences (Apple Menu or Dock > System Preferences), choose Sharing and the Services panel. Click Personal Web Sharing to check the box and start the Web server.

But before you go running off and writing, you might want to take care of a few optional configuration settings.

click here to configure blosxom...