blosxom :: the zen of blogging


  • home/about
  • features
  • colophon
  • news
  • mailing list

  • documentation for users

  • overview
  • install
  • configure
  • blog
  • view
  • flavour
  • syndicate
  • plugins
  • plugin registry
  • static
  • faq
  • use cases*
  • documentation for developers

  • overview
  • plugins
  • downloads

  • mac
  • windows*
  • everyone

  • license
  • contributed*
  • powered by

    Install Blosxom on your Mac by Hand

    Blosxom is a simple CGI script that requires not much more than being put somewhere Web-accessible, told where it is, optionally configured a little, blessed with permission to run, and let loose on an unsuspecting public.
    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.
    You should now be able to view your as-yet-blank Blosxom blog in your browser at http://localhost/cgi-bin/blosxom.cgi. Not particularly pretty, mind, without any blog entries or styling to speak of.

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