Formatting code for PhplistInstallation
[[PhplistDocumentation phpList Documentation]]
----
====Installing phpList====
===Short instructions===
>>If you are **upgrading** from an earlier version of phpList, see [[PhplistUpgrade Upgrading to the latest release]].
If you encounter **problems** during the installation, take a look at PhplistTroubleshooting.
>>
Installing phpList in a few steps:
~1)Unpack the distribution files. Make sure to use "create directories" when unpacking.
~1)This will create a directory called phplist-x.y.x where x.y.z is the version you unpacked.
~1)In this directory, there will be a directory ##public_html## which contains the directory ##lists##. Upload the "**lists**" directory into a directory that can be accessed via the web. The rest of the files are for reference only and are not needed for phplist to work.
~1)Create a database for phpList to use. phpList needs the name of that database during the installation process.
~1)Configure phpList by opening the ##config.php## file in the ##lists/config## directory in your preferred text editor. See [[PhpListConfiguration Configuration]].
~1)Go to the URL of the ##lists/admin## directory of your phpList installation. A web-based installer will walk you through the rest.
==Example==
If your website (lets say ""http://www.mysite.com"") is mapped to the directory ##/home/michael/www/##, and you have uploaded the phpList distribution files into ##/home/michael/www/lists/##, then you should go to: ##""http://www.mysite.com/lists/admin/""##.
===Longer version===
~1) **Download** the phpList files from the [[http://www.phplist.com phpList website]]. It is recommended to use the latest version marked as stable, unless you are interested in doing beta-testing (which is a good thing to be done, too).
~1) The file is a *.tar.gz file, which means that it is a packed file which you need to **unpack**. Windows users can use a program like Winzip, 7zip or Winrar for this. Make sure you let it re-create (sub)directories.
~1) Upload the **contents** of the **lists** directory, which you'll find in the public_html folder of the unpacked source tree into your web folder (something like //www// or //public_html//, for example //www-data// in Debian, Apache on Redhat Linux); or a subdirectory of that if you prefer.
~1) Create a **database** which phpList can use. phpList needs the name of that database during the installation process. If you can, use [[http://www.phpmyadmin.net/ phpMyAdmin]] for this, but you could also do it from the prompt. If your host won't let you create a new database, don't worry - you can use an existing one and specify a prefix for all the table names in the ##config.php## file so there won't be any conflicts. ---You also need to have (or create) a **user** for the database with sufficient permissions for phpList to use to access the database; this user needs all the usual permissions for reading, writing, modifying and deleting records, as well as for creating tables (which is what the installer is going to do); being allowed to drop tables (not databases) may also be needed later.
~1) With a simple text editor (not a word processor) open the phpList ##config.php## file in the ##lists/config/## directory and configure phplist properly. This may take a while. For detailed instructions on how to configure this file, see [[PhpListConfiguration Configuring phpList]].
~1) Point your browser to the web **directory** where the phplist backend is located, for instance: ##""http://www.mysite.com/lists/admin/""##. This will start the initializing process.
~1) Follow the **instructions** of the installer.
== ""OpenBSD"" ==
Marc Balmer maintains the [[http://www.openbsd.org OpenBSD]] port of phpList. ""OpenBSD"" users can simply execute //##pkg_add phplist##// to get phpList on their system.
==Related topics==
- [[SystemRequirements System requirements]]
- [[PhplistUpgrade Upgrading phpList]]
- [[PhpListConfiguration Configuring phpList]]
- [[PhplistTroubleshooting Troubleshooting]]
----
CategoryDocumentation
----
====Installing phpList====
===Short instructions===
>>If you are **upgrading** from an earlier version of phpList, see [[PhplistUpgrade Upgrading to the latest release]].
If you encounter **problems** during the installation, take a look at PhplistTroubleshooting.
>>
Installing phpList in a few steps:
~1)Unpack the distribution files. Make sure to use "create directories" when unpacking.
~1)This will create a directory called phplist-x.y.x where x.y.z is the version you unpacked.
~1)In this directory, there will be a directory ##public_html## which contains the directory ##lists##. Upload the "**lists**" directory into a directory that can be accessed via the web. The rest of the files are for reference only and are not needed for phplist to work.
~1)Create a database for phpList to use. phpList needs the name of that database during the installation process.
~1)Configure phpList by opening the ##config.php## file in the ##lists/config## directory in your preferred text editor. See [[PhpListConfiguration Configuration]].
~1)Go to the URL of the ##lists/admin## directory of your phpList installation. A web-based installer will walk you through the rest.
==Example==
If your website (lets say ""http://www.mysite.com"") is mapped to the directory ##/home/michael/www/##, and you have uploaded the phpList distribution files into ##/home/michael/www/lists/##, then you should go to: ##""http://www.mysite.com/lists/admin/""##.
===Longer version===
~1) **Download** the phpList files from the [[http://www.phplist.com phpList website]]. It is recommended to use the latest version marked as stable, unless you are interested in doing beta-testing (which is a good thing to be done, too).
~1) The file is a *.tar.gz file, which means that it is a packed file which you need to **unpack**. Windows users can use a program like Winzip, 7zip or Winrar for this. Make sure you let it re-create (sub)directories.
~1) Upload the **contents** of the **lists** directory, which you'll find in the public_html folder of the unpacked source tree into your web folder (something like //www// or //public_html//, for example //www-data// in Debian, Apache on Redhat Linux); or a subdirectory of that if you prefer.
~1) Create a **database** which phpList can use. phpList needs the name of that database during the installation process. If you can, use [[http://www.phpmyadmin.net/ phpMyAdmin]] for this, but you could also do it from the prompt. If your host won't let you create a new database, don't worry - you can use an existing one and specify a prefix for all the table names in the ##config.php## file so there won't be any conflicts. ---You also need to have (or create) a **user** for the database with sufficient permissions for phpList to use to access the database; this user needs all the usual permissions for reading, writing, modifying and deleting records, as well as for creating tables (which is what the installer is going to do); being allowed to drop tables (not databases) may also be needed later.
~1) With a simple text editor (not a word processor) open the phpList ##config.php## file in the ##lists/config/## directory and configure phplist properly. This may take a while. For detailed instructions on how to configure this file, see [[PhpListConfiguration Configuring phpList]].
~1) Point your browser to the web **directory** where the phplist backend is located, for instance: ##""http://www.mysite.com/lists/admin/""##. This will start the initializing process.
~1) Follow the **instructions** of the installer.
== ""OpenBSD"" ==
Marc Balmer maintains the [[http://www.openbsd.org OpenBSD]] port of phpList. ""OpenBSD"" users can simply execute //##pkg_add phplist##// to get phpList on their system.
==Related topics==
- [[SystemRequirements System requirements]]
- [[PhplistUpgrade Upgrading phpList]]
- [[PhpListConfiguration Configuring phpList]]
- [[PhplistTroubleshooting Troubleshooting]]
----
CategoryDocumentation
