Installation

Installation step by step guide

A clean install of Subtext is relatively painless. Essentially copy all the files to your webserver, create a database if you don't already have one, update web.config to point to your database, and you're all set. For more details on the setup instructions, keep reading.

If you are using a GoDaddy account, you may have to take a more manual approach.  Here is a blog post by someone who ran into problems and a workaround.

To install a Subtext release:

  1. Download the latest release from SourceForge. (Make sure to download the install release unless you plan on building the source yourself).
  2. Unzip the package into a directory on your local machine.
  3. Make sure you have a SQL Server 2000 database setup.
    (MSDE 2000 and SQL Server 2005 Express Edition will both work as well, and they're free)
  4. Make sure the database user has db owner permissions (this is necessary for the install process. You can downgrade permissions afterwards).
  5. Set up an IIS application, unless your hosting provider already has one set up for you.
  6. Open the web.config file and update the ConnectionString AppSettingvalue to match your database.
  7. Copy the installation files over to your web root.
  8. Configure the Custom 404 page.
  9. Navigate to your blog via the browser and follow the installation steps.
  10. [Optional] If you plan to use the Photo Galleries or plan to use the MetaWeblog API's MediaObject interface to upload images for your blog posts (via Windows Live Writer or desktop blog publishing software) you'll need to give the ASP.NET account Modify rights to your <blogroot>/Images/ directory.

Installation Screencasts

In order to simplify the installation of SubText in an hosting enviroment we produced 2 screencasts with the complete installation procedure (available both in broadband and low quality):

Subtext Logo design by TurboMilk.