This article is tagged because it NEEDS TECHNICAL REVIEW. You can help the Joomla! Documentation Wiki by contributing to it.
More pages that need help similar to this one are here. NOTE-If you feel the need is satistified, please remove this notice.
When you are first trying out Joomla!, it is often recommended that you install it on your local system. (e.g., "localhost"), for example with XAMPP, and get your site running locally. Eventually you may want to copy this site to your remote host. Fortunately, this is easy to do.
This article assumes you have installed Joomla! 1.5 on your local computer, you have created a website and you now wish to copy this website to your remote host.
Here are the steps:
If this is a new site, it will just be your home directory. If you have an existing site, for example www.domain.com, that you wish to keep while you work with Joomla!, you may be able to create a subdomain, for example, www.domain.com/subdirectory to hold your Joomla! site.
You have two methods:
Normally, the easiest way to copy these files is using an FTP client program, such as Filezilla.
Select all files from directory localhost (with XAMPP, the directory will be xampp/www/directory) and upload to the remote host HTML directory for a domain, or to the remote host HTML subdirectory.
|Dir LocalHost||Upload to Html Root||Or Upload Sub. Html Root|
|Select Dir.||Dir Filezilla.||Subdir Filezilla.|
Copying a large number of individual files using FTP can sometimes be unreliable. If you have command-line access to the both source and destination systems you can create a compressed archive file containing all the files on the source system, then transfer that single file to the destination system where it can be decompressed.
On Unix-style systems (eg. Linux) you can use the gzip program to create .zip files, or the tar program to create .tar.gz or .tar.bz2 files. For detailed instructions type man gzip or man tar at the command line. For example,
tar cvfz joomlabackup.tar.gz /path-to-joomla
will create a gzip-compressed archive file, called joomlabackup.tar.gz, containing all the files in your Joomla! installation. Important note! You need to make sure you are NOT in the folder you are trying to backup when you run the tar command or you will create an endless loop.
Having copied the archive file to the destination system, you now need to unpack it. Use the equivalent command that you used to create the archive file. For example, to unpack the archive file created in the example above, enter
cd /path-to-joomla tar xvfz joomlabackup.tar.gz
If the user or group IDs are not the same between the source and destination systems, then you will need to amend the ownership of the files you just extracted. For example, on an Apache system, you might need to enter the command
cd /path-to-joomla chown -R www-group.www-user *
In Joomla!, all the contents of the site (articles, menus, users, and so on) are stored in the MySql database. You need to copy this information to the host database. This is done by creating an export file on your local system and then importing this file into your host MySQL database, as follows:
At this point you have installed the database.
If you want to create a database copy, you can use also the MYSQL command line method. Usually you run mysqldump to create a database copy:
$ mysqldump -u user -p db-name > db-name.out
Copy db-name.out file using sftp/ssh to remote MySQL server:
$ scp db-name.out firstname.lastname@example.org:/backup
Restore database at remote server (login over ssh):
$ mysql -u user -p db-name < db-name.out
Manually edit "configuration.php" to tell Joomla! about your site. The file configuration.php contains settings specific to your system. This file was created for you when you installed Joomla! on your localhost. The settings in the configuration.php file that you typically need to change are shown below. This example is from a Windows XP localhost system.
var $log_path = 'C:\\xampp\\htdocs\\joomla15\\logs'; var $tmp_path = 'C:\\xampp\\htdocs\\joomla15\\tmp'; var $live_site = ''; var $host = 'localhost'; var $user = 'root'; var $db = 'your_local_db_name'; var $password = 'your_local_db_password';
Now, at you remote host system, the settings in the configuration.php file that you typically need to change are shown below
var $log_path = '/var/www/vhost/domain.com/home/html/logs'; var $tmp_path = '/var/www/vhost/domain.com/home/html/tmp'; var $live_site = ''; var $host = 'name your remote host'; var $user = 'your_user_db_name'; var $db = 'your_db_name'; var $password = 'your_db_password';
If you uploaded Joomla! files to a subdirectory, remember that you are working on subdirectory, and the settings that you need, will be,
var $log_path = '/var/www/vhost/domain.com/subdirectory/html/logs'; var $tmp_path = '/var/www/vhost/domain.com/subdirectory/html/tmp'; var $live_site = ''; var $host = 'name your remote host'; var $user = 'your_user_db_name'; var $db = 'your_db_name'; var $password = 'your_db_password';
At this point, your Joomla! Website on your host should be operational with the same information as your localhost site. If you installed it on a subdirectory, navigate to that subdirectory to see or administer the site.
http://www.domain.com/subdirectory (for navigatation to the site)
http://www.domain.com/subdirectory/administrator (login to the Joomla admin area with your user and password that your had at your localhost installed)
and if you installed it on root directory to see the site
http://www.domain.com/ (for navigatation to the site)
http://www.domain.com/administrator (login to admin area)
After you create the Database for your Joomla download and install Akeeba, it can be download from Joomla extension directory. There is a link to full instructions there as well.