Quick installation/upgrade guide
On this page:
Install the software for the first time
- Ensure your web server meets the Textpattern CMS system requirements.
- Download the latest
.zip
or.tar.gz
archive. - Create a new directory (e.g.
textpattern-archive
) on your local drive, move the downloaded archive file from step 2. into it, and unpack the file tree contents. - Open a file transfer connection to your destination server and upload the unpacked file tree to your web root, a subdomain or subdirectory. This destination directory should contain
css.php
,index.php
, plus thefiles
,images
,themes
andtextpattern
directories as a minimum. The.htaccess
file is required if your web server is Apache httpd or a derivative. Thesites
subdirectory is only required for optional multi-site functionality and therpc
directory is only required for optional XML-RPC functionality.README.txt
andHISTORY.txt
are optional. - Establish a known-good MySQL database, either for exclusive Textpattern use or shared, and note its associated username and password credentials.
- Open a web browser and go to
example.com/textpattern/setup/index.php
to start the setup process. If you’re running Textpattern from a subdomain or subdirectory, go tosubdomain.example.com/textpattern/setup/index.php
orexample.com/subdirectory/textpattern/setup/index.php
as appropriate. - Follow the instructions in the web browser.
If you require more information, please refer to the Detailed installation instructions.
Upgrade to the newest stable release
In the root directory of every Textpattern archive is a README.txt
file with upgrading instructions relevant to that release.
- Ensure your web server meets the Textpattern CMS system requirements.
- Download the latest
.zip
or.tar.gz
archive. - Create a new directory (e.g.
textpattern-upgrade
) on your local drive, move the downloaded archive file from step 2. into it, and unpack the file tree contents. - Log out of the Textpattern administration-side and clear the browser cache for your existing Textpattern site. If you use a service such as Cloudflare to cache your domain assets, remember to clear any caching services there too.
- Verify the existence of a working database and file backup of your existing Textpattern site. You may find it useful to copy your existing, known-good
textpattern/config.php
file to an easily accessible location on your local drive as it will be required shortly. - Open a file transfer connection to your destination server and upload the new
css.php
, andindex.php
files to your web server, overwriting the existing files. Upload the newtextpattern
directory, overwriting the existing directory. If you do not have athemes
directory, copy that too, otherwise leave it as-is. The new.htaccess
file is required if your web server is Apache httpd or a derivative and has an existing file. The newsites
subdirectory is only required if optional multi-site functionality is enabled and the newrpc
directory is only required if optional XML-RPC functionality is enabled. - Copy your known-good
textpattern/config.php
intotextpattern
. Delete thetextpattern/setup
directory. - Log in to the Textpattern administration-side. The relevant upgrade scripts are run automatically. Please take a look into diagnostics to confirm the upgraded version number is identified and whether there are any issues.
- Verify all preference settings.
If you require more information, please refer to the Detailed upgrading instructions.
Upgrades from versions below 4.2.0 will present this warning upon your very first login to the administration-side:
Warning: Unknown column 'user_name' in 'where clause' select name, val from txp_prefs where prefs_id=1 AND user_name='' in /path/to/your/site/textpattern/lib/txplib_db.php on line xx
This is expected behaviour for the very first login after the upgrade. Further navigation within the administration-side will continue without issue.