Installing new apps is a fairly straight-forward process, although Sitellite features no web-based interface for doing so*.

Apps all live in the inc/app folder of a Sitellite installation. To install a new app, use the following steps:

Unpack the new app into your inc/app folder:

tar -zxf new_app-1.0.0.tar.gz

Rename the app folder to eliminate the version number in its name:

mv newapp-1.0.0 newapp

Look in the app's install folder for a file named INSTALL.

This will contain instructions for completing the installation process. Usually these include one or more of the following:

Install the database schema for the app:

mysql -p -u USER DBNAME < newapp/install/install-mysql.sql
(enter password when prompted)

Copy any collection definition files into the inc/app/cms/conf/collections folder:

cp newapp/install/*.php cms/conf/collections/

Copy any scheduler tasks into the inc/app/scheduler/tasks folder:

Note: This example is taken from the SiteSearch app, which does have the following scheduler task.

cp -R sitesearch/install/sitesearch scheduler/tasks/

If you are upgrading an existing app, first make sure you've backed up your existing app and database contents before you begin, and second, look for any UPGRADE or upgrade-1.0.0-1.0.1.sql files in the install folder, which will guide you through the upgrade process.

---

Restricting access to apps

Using SiteTemplate as an example, to limit access to this app, create a new resource under Control Panel > Admin > Resources called app_sitetemplate. Next, edit the various user roles and allow or disallow access to this resource. Sitellite will now allow or disallow each role access to the SiteTemplate app.

---

*The reason for the lack of web-based app install/upgrade interface is because in order to make this possible, it would require making your entire inc/app folder and all sub-folders and files writeable by the web server user, which many site administrators would rather keep tighter security on.