GNU FM Installation Guide

Install GNUkebox.
1. Install ADOdb.
  On Debian-based systems, install the
```
libphp-adodb
```
  package using the package manager of your choice.
2. Copy the files under
```
gnu-fm/gnukebox/
```
  to some place under your web server's document root. This destination path will be hereafter referred to as
```
/path/to/gnukebox/
```
  . As a resource accessible via HTTP, it will be referred to as
```
http://your-host/gnukebox-document-root/
```
  .
3. Change the owner and group of the newly copied files, if necessary. On Debian-based systems, run the following command as root:
```
# chown -R www-data:www-data /path/to/gnukebox/
```
  Adjust the owner and group as necessary for your system.
4. Set up a database and user, if you're using PostgreSQL or MySQL.
5. Open
```
http://your-host/gnukebox-document-root/install.php
```
  .
6. Pick a database management system and fill in its configuration.
7. Verify that the submissions server URL is correct.
8. Click "Install".
Install Nixtape.
1. Install Smarty and Smarty Gettext.
  On Debian-based systems, install the
```
smarty
```
  and
```
smarty-gettext
```
  packages using the package manager of your choice. Then you have to run the following shell script as root (Debian's
```
smarty
```
  package is set up rather oddly, so this will create symbolic links at the location at which Nixtape expects to find Smarty):
```
# for file in /usr/share/php/smarty/libs/*; do ln -s "$file" "`echo $file | sed \"s@/usr/share/php/smarty/libs/@/usr/share/php/smarty/@\"`"; done
```
  If you have
```
sudo(1)
```
  configured, you can easily run this as follows:
```
$ sudo sh -c 'for file in /usr/share/php/smarty/libs/*; do ln -s "$file" "`echo $file | sed \"s@/usr/share/php/smarty/libs/@/usr/share/php/smarty/@\"`"; done'
```
  Or just use
```
su(1)
```
  as follows:
```
$ su -c 'for file in /usr/share/php/smarty/libs/*; do ln -s "$file" "`echo $file | sed \"s@/usr/share/php/smarty/libs/@/usr/share/php/smarty/@\"`"; done'
```
2. Copy the files under
```
gnu-fm/nixtape/
```
  to some place under your web server's document root. This destination path will be hereafter referred to as
```
/path/to/nixtape/
```
  . As a resource accessible via HTTP, it will be referred to as
```
http://your-host/nixtape-document-root/
```
  .
3. Change the owner and group of the newly copied files, if necessary.
  On Debian-based systems, run the following command as root:
```
# chown -R www-data:www-data /path/to/nixtape/
```
  Adjust the owner and group as necessary for your system.
4. Open
```
http://your-host/nixtape-document-root/install.php
```
  .
5. Set the database management system and its configuration to the values that you used for GNUkebox.
6. Verify that the base URL is correct.
7. Set the submissions server URL to that of your GNUkebox installation.
8. Click "Install".

Verify that GNUkebox is working.

Open

http://your-host/gnukebox-document-root/

Verify that Nixtape is working.
1. Open
```
http://your-host/nixtape-document-root/
```
  .
Install the "librefm" theme, if desired.
1. Copy the files under
```
librefm/gnukebox/
```
  to
```
/path/to/gnukebox/
```
  .
2. Recursively copy the directory
```
librefm/nixtape/themes/librefm/
```
  to
```
/path/to/nixtape/themes/
```
  .
3. Change the owner and group of the newly copied files, if necessary.
4. To make "librefm" the default theme in Nixtape, edit
```
/path/to/nixtape/config.php
```
  and change the value of
```
$default_theme
```
  .