Stash - Every good band deserves a back-end.

This page explains how to download and install Stash 1.0.3. If you are upgrading Stash please click here.

1. Download
2. Unpack
3. Create Directories
4. Set Permissions
5. Creating Database
6. Installer

Requirements

• Websever (ex: apache)
• PHP 5.0 or higher
• MySQL 4.0 or higher
• GD2 extension (included by default with PHP5)

Installing Stash

1. Download

Download the lastest version of Stash from http://www.nicestash.com/downloads.

2. Unpack

Unpack the archive (unzip stash-latest.zip). This will create a stash-x.y.z directory containing the Stash software.

The contents of the stash-x.y.z directory needs to be placed into a location of your webserver (ex: httpdocs/stash/ or public_html/stash/).

3. Create directories

Stash needs an "uploads/'', "releases/", "thumbs/", and "mp3/" directory on the server that are writable to store release images and mp3's.

To do this.

1. Manually create a directory named "uploads/" that is in the same directory as what you uploaded the files in Step 2 too.
2. Manually create two directories in "uploads/" one named "releases/" and the other named "mp3/".
3. Manually create a directory in "uploads/releases/" named "thumbs/".

You directory stucture should look something like this.

    ./stash
    ./uploads
     |----/mp3
     |----/releases
     |--------/thumbs

4. Setting Permissions

Stash needs write permissions to the following files and directories in order to work correctly.

    ./uploads/
    ./uploads/mp3/
    ./uploads/releases/
    ./uploads/releases/thumbs
    ./admin/config.php
    ./admin/template/
    ./admin/template/comments.tpl.php
    ./admin/template/discography.tpl.php
    ./admin/template/featurednews.tpl.php
    ./admin/template/featuredreleases.tpl.php
    ./admin/template/featuredtourdates.tpl.php
    ./admin/template/featuredvideos.tpl.php
    ./admin/template/news.tpl.php
    ./admin/template/newsarticle.tpl.php
    ./admin/template/pagination.tpl.php
    ./admin/template/releasepage.tpl.php
    ./admin/template/tourdates.tpl.php
    ./admin/template/tracklisting.tpl.php
    ./admin/template/videos.tpl.php

To make this work you have to chmod the files and directories.

• In most ftp programs you can set this by selecting the file info or using the set permissions command.
• Permissions should be "chmod 777 ."

5. Creating Database

If you do not already have a database that you like to use for Stash. You need to create one. If you do skip to step 6.

Creating database in cPanel

• From the main screen click MySQL® Databases
• Enter database name in New Database: field and click Create Database

Creating database in phpMyAdmin

phpMyAdmin is installed with most hosting companies admin panel. Ask your hosting provider if you are having trouble finding it.

• Find Create New Database.
• Enter database name.
• Click Create.

If all else fails ask your hosting provider how to create a database.

Don't worry about adding tables the installer will take care of that.

6. Installer

Access http://mybandsite.com/stash-directory/install in your favorite web browser.

Checking Permissions

First the installer will check to make sure all files and directories are present and writable. If you receive and error at this stage please repeat step 4.

Site Settings

Site Name:

Site Url:

Date Format:

Date Separator:

Database Information

Please have this info ready. If you do not know it you might have to contact your web hosting provider.

Hostname:

Database Name:

Username:

Password:

Table Prefix:

Admin Account

Here you will create the first account in order for you to log in to Stash. This will be the main admin account.

Finishing

Once you have all the information filled in, hit the submit button. Assuming there are no errors Stash will run the installer. Creating your config file and setting up the database tables. After Stash is successfully installed, please remove the install folder from your server.