Installation

Server Requirements

SoftwareRecommendedMinimumMore Information
PHP
(fastcgi, curl, bcmath, mbstring, mysqli, PDO, pdo_mysql, zip)
7.2+7.2http://www.php.net
MySQL
(Innodb support)
5.6.5+5.6.5http://www.mysql.com
*Apache2.4+2.4http://www.apache.org
*Nginx1.8+1.8https://www.nginx.com/resources/wiki/

*You must have installed at least one out of the two web servers.

Rewrite Rules

Before installing tinyCampaign, make sure the rewrite rules exist. Not all server setups are the same, so the Apache rewrite rules may need adjusting.

.htaccess

Nginx (root directory)

Nginx (subdirectory)

Create a Database

Before starting with the installation, you must first create a database. When creating the database, make sure that it has the following collation/charset: utf8mb4_unicode_ci

Install tinyCampaign

Now that you’ve uploaded the files to your server, you need to log into your server via ssh and navigate to the root of tinyCampaign (tinyC). After creating an ssh session, follow the instructions below.

Composer

  • Install composer if not already installed
  • Run composer to install needed libraries: `composer install`

Note: Windows users will need to install Cygwin to give them Linux type functionality via the command line.

  • chmod +x phinx (this is the file *without* the .php extension)
  • make a copy of phinx.sample.php and rename the copy to phinx.php. Open phinx.php and edit the database details. You must create the database first. tinyC will not create the database for you. Your phinx.php file should look similar to below once you’ve edited it:

After entering your database details, run the following command to start the install and database migration:

Once the installation is complete, you should see a message similar to below:

Once installed, you can login as the super administrator with the login details below. If your installation is a accessible via the web, please make sure to update the login details with something more secure. You can change your username via PHPMyAdmin, or you can use the Username Changer plugin which comes with the program.

  • Username: tinyc
  • Password: tinycampaign

Cookies and File Savepath

After the initial migration, a config.php file should now exist in the root of your installation. You should open it and edit the following:

The default session.save_path on most servers is /tmp/. However, if you restart your server, anything in the /tmp/ directory will be deleted. So, you should change the path of where important files should be saved. Please note, that these files must not be saved in the public directory.

As an example, if your installation is installed at /home/username/public_html/tinyc/, you will need to create a directory with the correct write permissions above the public directory (i.e. /home/username/tinyc_tmp). Now that we have our new folder (tinyc_tmp) created above the root and out of prying eyes, our new instantiated $app object will now look similar to below:

Now we are done, and tinyC is ready for use.

If you are having issues with your new installation, check out Debugging tinyCampaign.

Was this article helpful?

Related Articles