Continuing with the Textpattern CMS installation tutorial series, it’s now time to run the installer from the browser. The core Textpattern files have been copied to the web server, the database has been setup correctly and now the main installer can start. Before you start the installation, you will need to note down the following details from the database creation stage:
- Database name
- Database user
- Database user password
The install process is straightforward and shouldn’t cause you any problems, but you will be asked for the details above fairly early on. If you do encounter any issues, start a topic in the Arvixe forums or Textpattern forums.
Start the installer by visiting the setup page in your browser. There are two ways you can do this: firstly, go straight to the installer:
Alternatively you can load the Textpattern index.php file from your browser; it will tell you the config.php file cannot be located and provide you with a hyperlink to the installer. Both of these routes take you to the first screen of the installer, which looks like this:
Textpattern is multi-lingual, so choose your preferred option from the menu and click Submit. On the next screen, it’s straight down to business with database connection details. You’ll be presented with empty boxes to provide your MySQL database details:
Enter your details in the boxes. If you’re running one single instance of Textpattern on your site, you can leave the table prefix empty. It is possible to have more than one Textpattern instance in a single database, but frankly you have plenty of MySQL headroom on Arvixe so I recommend keeping one instance to one database. You should have something like this, but with your own details instead of mine:
Check your site address is correct and click Next. The installer will connect to your database server with the credentials supplied and, assuming it’s successful, will offer up text for a config file that you now need to create:
This file, config.php, needs to be located inside the ‘textpattern’ folder. You can make the file locally and then upload it to your web server, or create it directly on your server if your FTP client permits this. When you’ve made the file, click Next. Assuming the file is in the right place and the credentials check out, you’ll be asked to provide your details for a Textpattern account:
Note that these details are not the same as the database credentials: your user details are like any other website username + password combination. Make sure the password isn’t trivial and also that your email address is entered correctly. You can choose an admin theme if you like, too. Your admin theme can be selected from the administration interface after installation, if you like. You will end up with something like this:
That went well! Your Textpattern installation is now complete:
There’s a small amount of housekeeping to do before you’re absolutely done, but that’s quick and easy. Firstly, check that your username and password for the site are working by logging in. The Textpattern admin interface is accessed from the ‘textpattern’ folder, like this:
You’ll be presented with a login screen:
Enter your username and password (the Textpattern username and password, not the database credentials):
Click Login. The first time you log into a newly-installed or updated Textpattern, you will be taken straight to the language page to ensure the language strings are up-to-date:
If your language choice is showing as Updated, you need do nothing. If it’s showing Update, click on it to get the language strings up-to-date. Want to install a second language pack? No problem, there are 40+ to choose from; click Install on your language pack(s) of choice.
The last piece of housekeeping is to check the Diagnostics for errors. On a new installation, you should expect to see the Diagnostics panel warning you that the ‘setup’ directory still exists on the pre-flight check, like this:
Switch to your FTP client and remove the ‘textpattern/setup’ directory. Reload the Diagnostics and the pre-flight warning will be gone:
If you encounter any other errors in the Diagnostics pane, start a thread in the Arvixe forums or search the Textpattern forums for more information and a fix.
Congratulations, you just installed Textpattern!