Installing Tricho

Breaking news!

You can now access a demo of Tricho without having to install it. Use the following authentication details:

User: demo Password: demodemo

Otherwise, keep reading to see how to install Tricho on your own system.

Install Tricho in a few quick steps:

  1. Download Tricho

    The latest snapshot is 20140107. Extract it into the root directory of your development site.

  2. Set up the configuration files

    Copy the example config files from the tricho/config/examples directory into tricho/config. You will be editing the files in tricho/config.

    Open the file detect.php and make sure it will detect your development environment.

    Then add a random master salt to all.php. On Linux, you can generate a random string by running makepasswd --chars 40 in a terminal. You can of course choose a number of characters other than 40.

    Then put your site name, and database connection settings in test.php. You will also need to specify email addresses for the SITE_EMAIL, SITE_EMAILS_ERROR and SITE_EMAILS_ADMIN constants. You can do the same in live.php if you know what the live settings will be - but don't worry, you can do that later - any time before you launch your site.

  3. Run the install script

    Point your browser at http://your-server/tricho/install.php. This will set up all the tables that Tricho needs, which all begin with _tricho. It will also create the meta-data file admin/tables.xml, which describes the database and how its data should be validated. And it will create a top-level account for you to use in the admin area.

  4. Start working on your database

    You can use the tools in http://your-server/admin/setup to create new tables. Then go to http://your-server/admin to start filling them with data. You can also generate meta-data and forms for any existing tables that you have by visiting http://your-server/admin/generate_tables_xml.php.

  5. Write your front-end code

    How you do that is entirely up to you. Long live freedom!