CINXE.COM

<!DOCTYPE html> <html class="client-nojs" lang="en" dir="ltr"> <head> <meta charset="UTF-8"/> <title>J4.x:Installing Joomla - Joomla! Documentation</title> <script>document.documentElement.className="client-js";RLCONF={"wgBreakFrames":!1,"wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgRequestId":"186b3a1b904c23b652e522bd","wgCSPNonce":!1,"wgCanonicalNamespace":"J4.x","wgCanonicalSpecialPageName":!1,"wgNamespaceNumber":148,"wgPageName":"J4.x:Installing_Joomla","wgTitle":"Installing Joomla","wgCurRevisionId":993104,"wgRevisionId":993104,"wgArticleId":193313,"wgIsArticle":!0,"wgIsRedirect":!1,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Installation","Joomla! 4.x","Joomla! 4.0","Beginners"],"wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"J4.x:Installing_Joomla","wgRelevantArticleId":193313,"wgIsProbablyEditable":!1,"wgRelevantPageIsProbablyEditable":!1,"wgRestrictionEdit":[], "wgRestrictionMove":[],"wgMediaViewerOnClick":!0,"wgMediaViewerEnabledByDefault":!0,"wgULSAcceptLanguageList":["en-us","en"],"wgULSCurrentAutonym":"English","wgInternalRedirectTargetUrl":"/J4.x:Installing_Joomla","wgULSPosition":"personal","wgULSisCompactLinksEnabled":!0,"wgTranslatePageTranslation":"source"};RLSTATE={"site.styles":"ready","noscript":"ready","user.styles":"ready","user":"ready","user.options":"loading","ext.translate":"ready","ext.translate.tag.languages":"ready","skins.jforeground.styles":"ready","mediawiki.toc.styles":"ready","ext.uls.pt":"ready"};RLPAGEMODULES=["mediawiki.action.view.redirect","site","mediawiki.page.startup","mediawiki.page.ready","mediawiki.toc","skins.jforeground.js","mmv.head","mmv.bootstrap.autostart","ext.uls.compactlinks","ext.uls.interface","ext.translate.pagetranslation.uls"];</script> <script>(RLQ=window.RLQ||[]).push(function(){mw.loader.implement("user.options@1hzgi",function($,jQuery,require,module){/*@nomin*/mw.user.tokens.set({"patrolToken":"+\\","watchToken":"+\\","csrfToken":"+\\"}); });});</script> <link rel="stylesheet" href="/load.php?lang=en&modules=ext.translate%7Cext.translate.tag.languages%7Cext.uls.pt%7Cmediawiki.toc.styles%7Cskins.jforeground.styles&only=styles&skin=jforeground"/> <script async="" src="/load.php?lang=en&modules=startup&only=scripts&raw=1&skin=jforeground"></script> <meta name="ResourceLoaderDynamicStyles" content=""/> <link rel="stylesheet" href="/load.php?lang=en&modules=site.styles&only=styles&skin=jforeground"/> <meta name="generator" content="MediaWiki 1.35.10"/> <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes, minimum-scale=0.25, maximum-scale=5.0"/> <link rel="apple-touch-icon" href="/apple-touch-icon-precomposed.png"/> <link rel="shortcut icon" href="/favicon.ico"/> <link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="Joomla! Documentation (en)"/> <link rel="EditURI" type="application/rsd+xml" href="//docs.joomla.org/api.php?action=rsd"/> <link rel="license" href="/JEDL"/> <link rel="alternate" type="application/atom+xml" title="Joomla! Documentation Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom"/>  </head> <body class="mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-148 ns-subject page-J4_x_Installing_Joomla rootpage-J4_x_Installing_Joomla skin-jforeground action-view"><div id='navwrapper'>  <div id="top-nav" class="fixed"> <nav id="topnav" class="top-bar top row"> <ul class="title-area"> <li class="name logo"> <a href="/Main_Page"> <img alt="Joomla! Documentation" src="/skins/jforeground/joomla_logo_small.png" style="max-width: 64px;height:auto; max-height:36px; display: inline-block; vertical-align:middle;"></a> </li> <li class="toggle-topbar menu-icon"> <a href="#"><span> </span></a> </li> </ul> <section class="top-bar-section"> <ul id="top-bar-left" class="left"> <li class="has-dropdown active" id="p-sidebar-Joomla"> <a href="#">Joomla!</a> <ul class="dropdown"> <li id="n-sidebar-Main"><a href="https://www.joomla.org"><i class="fa fa-joomla 2x-fa icon"></i>Joomla! Home</a></li> <li id="n-sidebar-What"><a href="https://www.joomla.org/about-joomla.html">What is Joomla?</a></li> <li id="n-sidebar-Benefits"><a href="https://www.joomla.org/core-features.html">Benefits & Features</a></li> <li id="n-sidebar-Leadership"><a href="https://www.joomla.org/about-joomla/the-project.html">Project & Leadership</a></li> <li id="n-sidebar-Trademark"><a href="https://tm.joomla.org">Trademark & Licensing</a></li> <li class="divider"></li> <li id="label"><label>Support Joomla!</label></li> <li id="n-sidebar-Contribute"><a href="https://www.joomla.org/contribute-to-joomla.html">Contribute</a></li> <li id="n-sidebar-Sponsorship"><a href="https://www.joomla.org/sponsor.html">Sponsor</a></li> <li id="n-sidebar-Partner"><a href="https://www.joomla.org/about-joomla/partners.html">Partner</a></li> <li id="n-sidebar-Shop"><a href="https://shop.joomla.org/">Shop</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-Extend"> <a href="#">Download & Extend</a> <ul class="dropdown"> <li id="n-sidebar-JoomlaCode"><a href="https://downloads.joomla.org/">Downloads</a></li> <li id="n-sidebar-Extensions"><a href="https://extensions.joomla.org/">Extensions</a></li> <li id="n-sidebar-Translations"><a href="https://community.joomla.org/translations.html">Languages</a></li> <li id="n-sidebar-Free-Hosted"><a href="https://launch.joomla.org">Get a free site</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-About"> <a href="#">Discover & Learn</a> <ul class="dropdown"> <li id="n-sidebar-Docs"><a href="https://docs.joomla.org">Documentation</a></li> <li id="n-sidebar-Training"><a href="https://training.joomla.org">Training</a></li> <li id="n-sidebar-Certification"><a href="https://certification.joomla.org/">Certification</a></li> <li id="n-sidebar-Showcase"><a href="https://showcase.joomla.org/">Site Showcase</a></li> <li id="n-sidebar-Announcements"><a href="https://www.joomla.org/announcements.html">Announcements</a></li> <li id="n-sidebar-Blogs"><a href="https://community.joomla.org/blogs.html">Blogs</a></li> <li id="n-sidebar-Magazine"><a href="https://magazine.joomla.org/">Magazine</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-News"> <a href="#">Community & Support</a> <ul class="dropdown"> <li id="n-sidebar-Community"><a href="https://community.joomla.org/">Community Portal</a></li> <li id="n-sidebar-Events"><a href="https://events.joomla.org/">Events</a></li> <li id="n-sidebar-JUGs"><a href="https://community.joomla.org/user-groups.html">User Groups</a></li> <li id="n-sidebar-Forum"><a href="https://forum.joomla.org/">Forum</a></li> <li id="n-sidebar-Resources"><a href="https://resources.joomla.org/">Resources Directory</a></li> <li id="n-sidebar-Volunteers"><a href="https://volunteers.joomla.org/">Volunteers Portal</a></li> <li id="n-sidebar-Vel"><a href="https://vel.joomla.org">Vulnerable Extensions List</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-Developers"> <a href="#">Developer Resources</a> <ul class="dropdown"> <li id="n-sidebar-Developers"><a href="https://developer.joomla.org/">Developer Network</a></li> <li id="n-sidebar-Security"><a href="https://developer.joomla.org/security-centre.html">Security Centre</a></li> <li id="n-sidebar-Issues"><a href="https://issues.joomla.org/">Issue Tracker</a></li> <li id="n-sidebar-Github"><a href="https://github.com/joomla">GitHub</a></li> <li id="n-sidebar-API"><a href="https://api.joomla.org/">API Documentation</a></li> <li id="n-sidebar-Framework"><a href="https://framework.joomla.org/">Joomla! Framework</a></li> <li id="n-sidebar-JoomlaCode"><a href="http://joomlacode.org/">JoomlaCode</a></li> </ul> </li> </ul> <ul id="top-bar-right" class="right"> <li class="has-dropdown active"><a href="#"><i class="fa fa-cogs"></i></a> <ul id="toolbox-dropdown" class="dropdown"> <li id="t-whatlinkshere"><a href="/Special:WhatLinksHere/J4.x:Installing_Joomla" title="A list of all wiki pages that link here [j]" accesskey="j">What links here</a></li><li id="t-recentchangeslinked"><a href="/Special:RecentChangesLinked/J4.x:Installing_Joomla" rel="nofollow" title="Recent changes in pages linked from this page [k]" accesskey="k">Related changes</a></li><li id="t-specialpages"><a href="/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q">Special pages</a></li><li id="t-print"><a href="javascript:print();" rel="alternate" title="Printable version of this page [p]" accesskey="p">Printable version</a></li><li id="t-permalink"><a href="/index.php?title=J4.x:Installing_Joomla&oldid=993104" title="Permanent link to this revision of the page">Permanent link</a></li><li id="t-info"><a href="/index.php?title=J4.x:Installing_Joomla&action=info" title="More information about this page">Page information</a></li> <li id="n-recentchanges"><a href="/Special:RecentChanges" title="Special:RecentChanges">Recent changes</a></li> <li id="n-help" ><a href="/S:MyLanguage/Help:Contents">Help</a></li> </ul> </li> <li> <a href="/index.php?title=Special:UserLogin&returnto=J4.x%3AInstalling+Joomla">Log in</a> </li> </ul> </section> </nav> </div> <div id="global-header"> <nav class="global-header"> <div class="row"> <div class="large-6 column"> <h1 class="page-title"> <a href="/Main_Page"> <div class="title-name" style="display: inline-block;">Joomla! Documentation<sup>™</sup></div> </a> </h1> </div> <div class="large-6 column hide-for-small"> <ul class="button-group pull-right"> <li><a href="https://downloads.joomla.org/" class="button success radius" target="_blank">Download</a></li> <li><a href="https://launch.joomla.org/" class="button top radius" target="_blank">Launch</a></li> </ul> </div> </div> </nav> </div> <div id="bottom-nav"> <nav id="bottomnav" class="top-bar bottom row"> <ul class="title-area"> <li class="name"> <h1 class="title-name-small"> <a href="/Main_Page"> <div class="title-name" style="display:none;">Joomla! Documentation<sup>™</sup></div> </a> </h1> </li> <li class="toggle-topbar menu-icon"> <a href="#"><span></span></a> </li> </ul> <section class="top-bar-section"> <ul id="top-bar-left" class="left"> <li class="has-dropdown active" id='p-Learn'> <a href="#">Learn</a> <ul class="dropdown"> <li id="n-More-About-Joomla.21"><a href="/Special:MyLanguage/Portal:Learn_More">More About Joomla!</a></li><li id="n-Beginners"><a href="/Portal:Beginners">Beginners</a></li><li id="n-Administrators"><a href="/Portal:Administrators">Administrators</a></li><li id="n-Developers"><a href="/Portal:Developers">Developers</a></li><li id="n-Joomla.21-Get-Involved"><a href="/Portal:Participating_in_the_Community">Joomla! Get Involved</a></li><li id="n-Joomla.21-Code-Contributors"><a href="/Portal:Joomla!_Code_Contributors">Joomla! Code Contributors</a></li><li id="n-Joomla-User-Groups"><a href="/Special:MyLanguage/Portal:Joomla_User_Groups">Joomla User Groups</a></li> </ul> <li class="has-dropdown active" id='p-Browse'> <a href="#">Browse</a> <ul class="dropdown"> <li id="n-CMS-Help-Screens"><a href="/Help_screens">CMS Help Screens</a></li><li id="n-Our-Docs"><a href="/Category:Top_Level">Our Docs</a></li><li id="n-Our-Glossary"><a href="/Glossary">Our Glossary</a></li><li id="n-The-Joomla.21-FAQs"><a href="/Category:FAQ">The Joomla! FAQs</a></li><li id="n-Tips-and-tricks"><a href="/Category:Tips_and_tricks">Tips and tricks</a></li><li id="n-Recent-Changes"><a href="/Special:RecentChanges">Recent Changes</a></li> </ul> <li class="has-dropdown active" id='p-Help'> <a href="#">Help</a> <ul class="dropdown"> <li id="n-Contribute-to-Joomla.21-Docs"><a href="/JDOC:How_to_Contribute_to_Joomla!_Documentation">Contribute to Joomla! Docs</a></li><li id="n-Translate-Joomla.21-Docs"><a href="/JDOC:Documentation_Translators">Translate Joomla! Docs</a></li><li id="n-Editing-Help"><a href="/JHelp:Cheatsheet">Editing Help</a></li><li id="n-Play-in-the-Sandbox"><a href="/Sandbox">Play in the Sandbox</a></li><li id="n-JDOC.27s-Policies"><a href="/JDOC:Wiki_policy">JDOC's Policies</a></li><li id="n-Documentation-License"><a href="/JEDL">Documentation License</a></li><li id="n-More-Help"><a href="https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents" rel="nofollow" target="_blank">More Help</a></li> </ul> </ul> <ul id="top-bar-right" class="right"> <li class="has-form"> <form action="/index.php" id="searchform" class="mw-search"> <div class="row"> <div class="small-12 columns"> <input type="search" name="search" placeholder="Search Joomla! Documentation" title="Search Joomla! Documentation [f]" accesskey="f" id="searchInput"/> <button type="submit" class="button search main">Search</button> </div> </div> </form> </li> </ul> </section> </nav> </div> </div> <div id="page-content"> <div class="row"> <div class="large-12 columns">   <div class="mw-indicators mw-body-content"> </div>  </div> </div> <div id="mw-js-message" style="display:none;"></div> <div class="row"> <div id="p-cactions" class="large-12 columns"> <h4 class="namespace label">J4.x</h4> <article id="content"> <h1 class="title">Installing Joomla</h1> <h3 id="tagline">From Joomla! Documentation</h3> <h5 class="subtitle"></h5> <div id="ad"> <script async="" type="text/javascript" src="//cdn.carbonads.com/carbon.js?zoneid=1673&serve=C6AILKT&placement=joomlaorg" id="_carbonads_js"></script> </div> <div class="clear_both"></div> <div class="mw-bodytext"> <div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-pt-languages noprint" lang="en" dir="ltr"><div class="mw-pt-languages-label">Other languages:</div><div class="mw-pt-languages-list"><a href="/J4.x:Installing_Joomla/id" class="mw-pt-progress mw-pt-progress--stub" title="Memasang Joomla (3% translated)" lang="id">Bahasa Indonesia</a> • ‎<a href="/J4.x:Installing_Joomla/de" class="mw-pt-progress mw-pt-progress--complete" title="Joomla! installieren (100% translated)" lang="de">Deutsch</a> • ‎<span class="mw-pt-languages-ui mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete" lang="en">English</span> • ‎<a href="/J4.x:Installing_Joomla/nl" class="mw-pt-progress mw-pt-progress--complete" title="Het installeren van Joomla (100% translated)" lang="nl">Nederlands</a> • ‎<a href="/J4.x:Installing_Joomla/et" class="mw-pt-progress mw-pt-progress--stub" title="J4.x:Joomla paigaldamine (3% translated)" lang="et">eesti</a> • ‎<a href="/J4.x:Installing_Joomla/es" class="mw-pt-progress mw-pt-progress--stub" title="Instalación de Joomla (19% translated)" lang="es">español</a> • ‎<a href="/J4.x:Installing_Joomla/fr" class="mw-pt-progress mw-pt-progress--complete" title="Installation de Joomla! (100% translated)" lang="fr">français</a> • ‎<a href="/J4.x:Installing_Joomla/it" class="mw-pt-progress mw-pt-progress--low" title="J4.x:Installazione di Joomla (24% translated)" lang="it">italiano</a> • ‎<a href="/J4.x:Installing_Joomla/pt-br" class="mw-pt-progress mw-pt-progress--complete" title="J4.x: Instalando o Joomla! (100% translated)" lang="pt-BR">português do Brasil</a> • ‎<a href="/J4.x:Installing_Joomla/fa" class="mw-pt-progress mw-pt-progress--stub" title="J4.x:نصب جوملا (1% translated)" lang="fa">فارسی</a> • ‎<a href="/J4.x:Installing_Joomla/zh-tw" class="mw-pt-progress mw-pt-progress--low" title="J4.x:安裝 Joomla (24% translated)" lang="zh-Hant-TW">中文（台灣）‎</a> • ‎<a href="/J4.x:Installing_Joomla/ja" class="mw-pt-progress mw-pt-progress--low" title="Joomlaのインストール (22% translated)" lang="ja">日本語</a></div></div> <div id="toc" class="toc" role="navigation" aria-labelledby="mw-toc-heading"><input type="checkbox" role="button" id="toctogglecheckbox" class="toctogglecheckbox" style="display:none" /><div class="toctitle" lang="en" dir="ltr"><h2 id="mw-toc-heading">Contents</h2><span class="toctogglespan"><label class="toctogglelabel" for="toctogglecheckbox"></label></span></div> <ul> <li class="toclevel-1 tocsection-1"><a href="#Introduction"><span class="tocnumber">1</span> <span class="toctext">Introduction</span></a> <ul> <li class="toclevel-2 tocsection-2"><a href="#Hosting_Setup"><span class="tocnumber">1.1</span> <span class="toctext">Hosting Setup</span></a></li> <li class="toclevel-2 tocsection-3"><a href="#Database_Setup"><span class="tocnumber">1.2</span> <span class="toctext">Database Setup</span></a></li> </ul> </li> <li class="toclevel-1 tocsection-4"><a href="#Prepare_for_Install"><span class="tocnumber">2</span> <span class="toctext">Prepare for Install</span></a> <ul> <li class="toclevel-2 tocsection-5"><a href="#Downloading_and_Uploading_Joomla.21_Package_Files"><span class="tocnumber">2.1</span> <span class="toctext">Downloading and Uploading Joomla! Package Files</span></a></li> </ul> </li> <li class="toclevel-1 tocsection-6"><a href="#Start_Install"><span class="tocnumber">3</span> <span class="toctext">Start Install</span></a></li> <li class="toclevel-1 tocsection-7"><a href="#Login_Data"><span class="tocnumber">4</span> <span class="toctext">Login Data</span></a></li> <li class="toclevel-1 tocsection-8"><a href="#Database_Configuration"><span class="tocnumber">5</span> <span class="toctext">Database Configuration</span></a></li> <li class="toclevel-1 tocsection-9"><a href="#Finishing_Up"><span class="tocnumber">6</span> <span class="toctext">Finishing Up</span></a> <ul> <li class="toclevel-2 tocsection-10"><a href="#Success_and_Finishing_Up_the_Installation"><span class="tocnumber">6.1</span> <span class="toctext">Success and Finishing Up the Installation</span></a></li> <li class="toclevel-2 tocsection-11"><a href="#Extra_Languages"><span class="tocnumber">6.2</span> <span class="toctext">Extra Languages</span></a> <ul> <li class="toclevel-3 tocsection-12"><a href="#Install_Additional_Languages"><span class="tocnumber">6.2.1</span> <span class="toctext">Install Additional Languages</span></a></li> <li class="toclevel-3 tocsection-13"><a href="#Choose_the_Default_Language"><span class="tocnumber">6.2.2</span> <span class="toctext">Choose the Default Language</span></a></li> <li class="toclevel-3 tocsection-14"><a href="#Finalise"><span class="tocnumber">6.2.3</span> <span class="toctext">Finalise</span></a></li> </ul> </li> </ul> </li> <li class="toclevel-1 tocsection-15"><a href="#Related_Information"><span class="tocnumber">7</span> <span class="toctext">Related Information</span></a></li> </ul> </div> <h2><span class="mw-headline" id="Introduction">Introduction</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=1" title="Edit section: Introduction">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>Installing Joomla! for the first time is very easy. After completion of the preliminary steps, setting up a hosting environment and creating a database, Joomla’s built-in web installer will set up your new site in just a few minutes. The previous steps: </p> <h3><span class="mw-headline" id="Hosting_Setup">Hosting Setup</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=2" title="Edit section: Hosting Setup">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>If you have not yet set up a hosting environment you need to do it now, either on a hosting service or your local computer. Read the <a href="/J4.x:Hosting_Setup" title="J4.x:Hosting Setup">Hosting Setup</a> tutorial for details. </p><p>Also, there are some PHP settings that need to be sufficient for Joomla to install. The settings are usually in a <i>php.ini</i> or <i>user.ini</i> configuration file on the server. If you are on shared hosting, talk to your hosting service about how to change these settings if it is possible to do so. If working on a localhost, for example with <a href="/Special:MyLanguage/XAMPP" title="Special:MyLanguage/XAMPP">XAMPP</a>, or a VPS or dedicated host, you should not be restricted by these settings and can set them yourself. </p><p>The minimum values for the <i>php.ini</i> file are shown below: </p> <ul><li><i>memory_limit:</i> 256M</li> <li><i>upload_max_filesize:</i> 30M</li> <li><i>post_max_size:</i> 30M</li> <li><i>max_execution_time:</i> 30</li></ul> <p>It is possible to work with lower values of upload_max_filesize and post_max_size but larger extensions will fail to upload and cause unpredictable problems. </p> <h3><span class="mw-headline" id="Database_Setup">Database Setup</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=3" title="Edit section: Database Setup">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>If you have not yet set up a database do it now. It is covered for a hosting service in the <a href="/J4.x:Hosting_Setup" title="J4.x:Hosting Setup">Hosting Setup</a> tutorial. There is also a <a href="/Special:MyLanguage/Creating_a_Database_for_Joomla!" title="Special:MyLanguage/Creating a Database for Joomla!">Creating a Database for Joomla!</a> tutorial that covers localhost and phpMyAdmin methods. </p><p>You will need to note basic database information needed when the actual Joomla installation is started. </p> <ul><li>Location of database, usually <i>localhost</i> even on a hosting service. It can be a specific host's server such as <code><i>dbserver1.yourhost.com</i></code>.</li> <li>The database name</li> <li>The database user's name</li> <li>The database user's password</li></ul> <h2><span class="mw-headline" id="Prepare_for_Install">Prepare for Install</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=4" title="Edit section: Prepare for Install">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <h3><span id="Downloading_and_Uploading_Joomla!_Package_Files"></span><span class="mw-headline" id="Downloading_and_Uploading_Joomla.21_Package_Files">Downloading and Uploading Joomla! Package Files</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=5" title="Edit section: Downloading and Uploading Joomla! Package Files">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>Download the current release of Joomla! from the link on the <a target="_blank" rel="noreferrer noopener" class="external text" href="https://downloads.joomla.org/">Download Joomla</a> page </p><p>Move the downloaded Joomla installation package zip file to the server. For a hosting service you may use the cPanel File Manager Upload function or you may use an FTP Client to transfer the downloaded Joomla 4.x zip file to your server. There are several FTP clients available. Here is a detailed <a target="_blank" rel="nofollow noreferrer noopener" class="external text" href="https://en.wikipedia.org/wiki/Comparison_of_FTP_client_software">Comparison of FTP client software</a>. If in doubt, use FileZilla. </p> <div class="panel radius ambox-tip"><div class="subheader-ambox"><icon class="fa fa-lightbulb-o fa-2x" style="color:#000;"></icon><div class="ambox-title">Your Server's "root" Folder<div style="font-size:.7em;float:right"></div></div></div><p class="ambox" style="font-size:.9em;">It is better to move the downloaded zip package to your server and unpack it there than to unpack it locally and then move the file tree. Normally you upload your web files to the root folder of your hosting service. This is typically named <i>public_html</i> but other variations include <i>htdocs</i> and this depends on how your host has the set up the server. For Joomla purposes, you can load the files directly into <i>public_html</i> or a sub-folder you have created within it.</p></div> <div class="panel radius ambox-serious"><div class="subheader-ambox"><a href="/File:Stop_hand_nuvola.svg.png" class="image"><img alt="Stop hand nuvola.svg.png" src="/images/thumb/4/41/Stop_hand_nuvola.svg.png/25px-Stop_hand_nuvola.svg.png" decoding="async" width="25" height="25" srcset="/images/thumb/4/41/Stop_hand_nuvola.svg.png/38px-Stop_hand_nuvola.svg.png 1.5x, /images/4/41/Stop_hand_nuvola.svg.png 2x" data-file-width="40" data-file-height="40" /></a><div class="ambox-title">Warning!<div style="font-size:.7em;float:right"></div></div></div><p class="ambox" style="font-size:.9em;">If you unpack the files on your own computer, then copy them to your server, be sure to move only the folders and files contained <b>inside</b> the Joomla package. If you unpack the folders and files into a folder, for example called, <code><i>Joomla</i></code> and then upload that folder, your site will have to be accessed at <code><i>yoursitename.com/Joomla</i></code> instead of <code><i>yoursitename.com</i></code>. You can rename the sub-directory from Joomla to something more site appropriate, such as jblog, and you might find that convenient. <b>Note</b> directory names should be lower case, without spaces and using minus signs rather than underlines to separate words.</p></div> <p>The zip package files can be extracted directly on the host using various command line tools (e.g. unzip), which needs to be installed on the server. If your hosting service uses the admin tool cPanel, the Extract button can be pressed in the File Manager. Apart from that, the free third-party tool <a target="_blank" rel="nofollow noreferrer noopener" class="external text" href="https://www.akeeba.com/products/akeeba-kickstart.html">Akeeba Kickstart</a> may also be used for this purpose. The unzipped files and directories will be placed in the current folder. Extraction on your local computer depends on your OS. Try a right-click and see if there is an extract menu. In this case your OS may put the files in a folder with the same name as the zip file. After extraction you may delete the zip file and rename the extraction folder to something short and suitable for use in a url. </p> <h2><span class="mw-headline" id="Start_Install">Start Install</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=6" title="Edit section: Start Install">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>With the above requirements met, a database created and the required Joomla files in place, you are ready to install Joomla. Start the Joomla web installer by opening your favourite browser and browsing to the site's domain name. On a hosting installation you will use <code><i>https://www.yoursitename.com</i></code>. If your are installing Joomla locally, you will use <code><i>http://localhost/<path to Joomla files></i></code> and you should see the installation screen. </p> <div class="floatright"><a href="/File:J4x_Installation_screen_page_1.png" class="image"><img alt="J4x Installation screen page 1.png" src="/images/0/06/J4x_Installation_screen_page_1.png" decoding="async" width="500" height="397" class="thumbborder" data-file-width="500" data-file-height="397" /></a></div> <p>Joomla will try to identify the <i>Select Language</i> field automatically from your browser's language. You can change this if needed. </p><p>Fill in the following information. </p> <ul><li><b>Site Name</b>: The name of your website — this can be changed at any point later in the <a href="/Special:MyLanguage/Help40:Site_Global_Configuration#Site" title="Special:MyLanguage/Help40:Site Global Configuration">Site Global Configuration</a> page.</li></ul> <p>When everything on the first page is completed, click the <i>Setup Login Data</i> button to proceed. </p> <div style="clear:both;"></div> <h2><span class="mw-headline" id="Login_Data">Login Data</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=7" title="Edit section: Login Data">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>You should now see the login data screen. </p> <div class="floatright"><a href="/File:J4x_Installation_screen_page_2.png" class="image"><img alt="J4x Installation screen page 2.png" src="/images/6/66/J4x_Installation_screen_page_2.png" decoding="async" width="500" height="481" class="thumbborder" data-file-width="500" data-file-height="481" /></a></div> <p>Fill in the following information. </p> <ul><li><b>Real Name</b>: The name of the Super User. This is how Joomla will greet you when you log in.</li> <li><b>Super User account username</b>: The username for the <i>Super User</i>. Avoid using <i>admin</i> (a good <a href="/Special:MyLanguage/Security_Checklist/Joomla!_Setup#Change_the_default_administrator_username" title="Special:MyLanguage/Security Checklist/Joomla! Setup">Security measure</a>) or use <a href="/Special:MyLanguage/Help40:Site_My_Profile" title="Special:MyLanguage/Help40:Site My Profile">My Profile</a> in the <i>Administration</i> interface to change it later.</li> <li><b>Admin Password</b>: Remember that a Super User has maximum control of the Site and Administrator interfaces, so use a difficult password. Use <a href="/Special:MyLanguage/Help40:Site_My_Profile" title="Special:MyLanguage/Help40:Site My Profile">My Profile</a> in the <i>Administration</i> interface to change it later.</li> <li><b>Super User Email Address</b>: The Super User email address. Enter a valid email in case you forget your password. This is the email address where you'll receive a link to change the Super User password.</li></ul> <p>When everything on the second page is completed, click the <i>Setup Database Connection</i> button to proceed. </p> <div style="clear:both;"></div> <h2><span class="mw-headline" id="Database_Configuration">Database Configuration</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=8" title="Edit section: Database Configuration">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>Enter the database information noted down when you created the database for this installation. You may also read or review <a href="/Special:MyLanguage/Creating_a_Database_for_Joomla!" title="Special:MyLanguage/Creating a Database for Joomla!">Creating a Database for Joomla!</a>. </p> <div class="floatright"><a href="/File:J40_Installation_screen_page_3.png" class="image"><img alt="J40 Installation screen page 3.png" src="/images/4/4f/J40_Installation_screen_page_3.png" decoding="async" width="500" height="637" class="thumbborder" data-file-width="500" data-file-height="637" /></a></div> <p>For simplification, these instructions are a reference to installing with a <a href="https://en.wikipedia.org/wiki/MySQLi" class="extiw" title="wikipedia:MySQLi">MySQLi</a> database. The instructions on the installation page are self explanatory, but here they are again: </p> <ul><li><b>Database Type</b>: MySQLi is the common database used</li> <li><b>Hostname</b> Where your database is located. Common is <i>localhost</i>, even on hosting services. However, some hosts use a specific database server such as <i>dbserver1.yourhost.com</i>.</li> <li><b>Username</b>: The username used to connect to the database</li> <li><b>Password</b>: The password for the database user (not your Administrator password)</li> <li><b>Database Name</b>: The name of the database</li> <li><b>Table Prefix</b>: This is generated automatically as a security feature. You can accept the randomly generated default or change it. Just don't forget to put the underscore character (<code>_</code>) at the end of the prefix.</li> <li><b>Connection Encryption</b>: specifies how the connection to the database should be encrypted. If you don't know - then it's best to stick to the default. However this allows enterprises that use one or two way authentication for the database connection to provide it.</li></ul> <p>All these choices and more can be edited on the <a href="/Special:MyLanguage/Help40:Site_Global_Configuration#Server" title="Special:MyLanguage/Help40:Site Global Configuration">Site Global Configuration</a> page, under <i>Server Options</i> after the installation is completed. Note, you will break your installation if you change these settings after installation unless you have a complete copy of the current database being used by the Joomla installation. Common uses would be to update the username and password of the database or to complete a move of an existing installation to a new host with different parameters. </p><p>After you click the <i>Install Joomla</i> button, you should see the Joomla logo spinning. Once the installation completes, you should see the success page. </p> <div style="clear:both;"></div> <h2><span class="mw-headline" id="Finishing_Up">Finishing Up</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=9" title="Edit section: Finishing Up">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <h3><span class="mw-headline" id="Success_and_Finishing_Up_the_Installation">Success and Finishing Up the Installation</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=10" title="Edit section: Success and Finishing Up the Installation">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>Congratulations! Joomla! 4 is now installed. </p> <div class="floatright"><a href="/File:J40_Installation_screen_page_4.png" class="image"><img alt="J40 Installation screen page 4.png" src="/images/e/e0/J40_Installation_screen_page_4.png" decoding="async" width="500" height="318" class="thumbborder" data-file-width="500" data-file-height="318" /></a></div> <p>If you want to start using Joomla right away without <a href="/Special:MyLanguage/J4.x:Installing_Joomla#Installing_Extra_Languages" title="Special:MyLanguage/J4.x:Installing Joomla">installing extra languages</a> you can select <i>Open Administrator</i> to go to the <i>Administrator Dashboard</i> or select <i>Open Site</i> to go to the Site Home page. You may see a section with recommended PHP settings. </p> <ul><li><b>Recommended Settings</b>: These settings are recommended in your PHP configuration, but will not prevent Joomla! from being installed. You can refer to the above instructions on how they may be changed if there is a need to do so.</li></ul> <div style="clear:both"></div> <h3><span class="mw-headline" id="Extra_Languages">Extra Languages</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=11" title="Edit section: Extra Languages">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>As part of the Joomla installation process you are given the opportunity to install additional languages before you complete the installation. </p><p>To do this select the Install Additional Languages button </p><p>This will take you to an extra installation page allowing you to select the languages you require. </p> <div style="clear:both;"></div> <h4><span class="mw-headline" id="Install_Additional_Languages">Install Additional Languages</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=12" title="Edit section: Install Additional Languages">edit</a><span class="mw-editsection-bracket">]</span></span></h4> <p>A list of language packs is displayed. </p> <div class="floatright"><a href="/File:J40_Installation_screen_page_5.png" class="image"><img alt="J40 Installation screen page 5.png" src="/images/c/ce/J40_Installation_screen_page_5.png" decoding="async" width="500" height="755" data-file-width="500" data-file-height="755" /></a></div> <p>Select up to 3 languages you wish to install. (More than 3 at once can cause timeout issues; you can install more later.) </p><p>Remember the following: </p> <ul><li>Language packs included in custom distributions will not be listed at this stage as they are already installed.</li> <li>A version of the packs proposed will match the Joomla Major version (4.0.x, 4.1.x, etc.). The minor version of the pack may not correspond, e.g. you are installing version 4.0.3 and a 4.0.2 language pack is shown.</li> <li>Unmatched language packs in the above example may have untranslated strings.</li> <li>The unmatched language packs will be offered as an update when the packs are updated by the registered Translation teams. The available update will be shown in the Control panel as well as in <b>Extensions Manager<span style="font-size:1.40em;"> </span></b>→<b> Update</b>. This behaviour is similar to <b>Extensions Manager<span style="font-size:1.40em;"> </span></b>→<b> Install Languages</b>.</li></ul> <p>Click <i>Next</i> and a progress bar will be displayed while the language pack or packs are installed. </p> <div style="clear:both"></div> <h4><span class="mw-headline" id="Choose_the_Default_Language">Choose the Default Language</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=13" title="Edit section: Choose the Default Language">edit</a><span class="mw-editsection-bracket">]</span></span></h4> <p>When the installation of the languages is complete you will now be presented with a similar <i>Congratulations! Your Joomla site is ready.</i> screen. The difference will be a list of the installed languages allowing you to select the default language for the Site and the Administrator interface. </p> <div class="floatright"><a href="/File:J40_Installation_screen_page_4_default_langs.png" class="image" title="500"><img alt="500" src="/images/d/d2/J40_Installation_screen_page_4_default_langs.png" decoding="async" width="500" height="650" class="thumbborder" data-file-width="500" data-file-height="650" /></a></div> <ul><li>Select the default language you wish to use.</li> <li>When you have selected the default language, click the <i>Set default language</i> button to confirm.</li> <li>A system message will be displayed confirming Joomla has set the default <b>Administrator</b> and <b>Site</b> language. That message can be closed.<div style="clear:both;"></div></li></ul> <h4><span class="mw-headline" id="Finalise">Finalise</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=14" title="Edit section: Finalise">edit</a><span class="mw-editsection-bracket">]</span></span></h4> <p>You can now can navigate to the <i>Administrator Dashboard</i>. Log in by selecting <i>Open Administrator</i> or go right to your site Home page by selecting <i>Open Site</i>. </p> <h2><span class="mw-headline" id="Related_Information">Related Information</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Installing_Joomla&action=edit&section=15" title="Edit section: Related Information">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <ul><li><a href="/Special:MyLanguage/J4.x:Hosting_Setup" title="Special:MyLanguage/J4.x:Hosting Setup">Hosting Setup</a></li> <li><a href="/Special:MyLanguage/Security_Checklist/Hosting_and_Server_Setup" title="Special:MyLanguage/Security Checklist/Hosting and Server Setup">Hosting and Server Setup</a></li> <li><a href="/Special:MyLanguage/Creating_A_VPS_Testing_Server" title="Special:MyLanguage/Creating A VPS Testing Server">Creating A VPS Testing Server</a></li> <li><a href="/Special:MyLanguage/J4.x:Setting_Up_Your_Local_Environment" title="Special:MyLanguage/J4.x:Setting Up Your Local Environment">Setting up your local environment</a></li> <li><a href="/Special:MyLanguage/J4.x:Joomla_CLI_Installation" title="Special:MyLanguage/J4.x:Joomla CLI Installation">Joomla CLI Installation</a></li></ul>    </div></div></div><div class="printfooter"> Retrieved from "<a dir="ltr" href="https://docs.joomla.org/index.php?title=J4.x:Installing_Joomla&oldid=993104">https://docs.joomla.org/index.php?title=J4.x:Installing_Joomla&oldid=993104</a>"</div> <div class="clear_both"></div> </div> <div class="group"><div id="catlinks" class="catlinks" data-mw="interface"><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/Special:Categories" title="Special:Categories">Categories</a>: <ul><li><a href="/Category:Installation" title="Category:Installation">Installation</a></li><li><a href="/Category:Joomla!_4.x" title="Category:Joomla! 4.x">Joomla! 4.x</a></li><li><a href="/Category:Joomla!_4.0" title="Category:Joomla! 4.0">Joomla! 4.0</a></li><li><a href="/Category:Beginners" title="Category:Beginners">Beginners</a></li></ul></div></div></div> </article> </div> </div> <footer class="row"> <div id="footer"> <div id="footer-left" class="large-8 small-12 columns"> <ul id="footer-left"> <li id="footer-lastmod"> This page was last edited on 25 October 2022, at 10:44.</li> <li id="footer-copyright">Content is available under <a href="/JEDL" title="JEDL">Joomla! EDL</a> unless otherwise noted.<br>Joomla!<sup>®</sup> is a registered trademark of Open Source Matters, Inc.<br>If you are experiencing technical issues with this website, <html><a href="https://github.com/joomla/joomla-websites/issues/new?title=%5Bjdocs%5D%20&body=Please%20describe%20the%20problem%20or%20your%20issue" target="_blank" rel="nofollow">please report it</a> </html>. <br>Notice a content problem? <html><a href="/JDOC:How_to_Contribute_to_Joomla!_Documentation" rel="nofollow">Create an account</a> </html> and fix it.</li> <li id="footer-privacy"><a href="/JDOC:Privacy_policy" title="JDOC:Privacy policy">Privacy policy</a></li> <li id="footer-about"><a href="/JDOC:About" title="JDOC:About">About Joomla! Documentation</a></li> <li id="footer-disclaimer"><a href="/JDOC:General_disclaimer" class="mw-redirect" title="JDOC:General disclaimer">Terms of Service</a></li> </ul> </div> <div id="footer-right-icons" class="large-4 small-12 columns"> <ul id="poweredby"> <li class="copyright"> <a href="https://docs.joomla.org/JEDL" target="_blank"><img src="https://docs.joomla.org/skins/JEDL_icon.png" alt="Joomla! EDL" width="88" height="31" loading="lazy"/></a> </li> <li class="poweredby"> <a href="https://www.mediawiki.org/" target="_blank"><img src="/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31" loading="lazy"/></a> </li> <li class="rochen"> <a href="https://www.rochen.com/joomla-hosting" target="_blank"><img src="//cdn.joomla.org/rochen/rochen_footer_logo_white.png" alt="Joomla! Hosting by Rochen..." width="88" height="31" loading="lazy"/></a> </li> </ul> </div> </div> </footer> </div> <script>(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgPageParseReport":{"limitreport":{"cputime":"0.098","walltime":"0.121","ppvisitednodes":{"value":405,"limit":1000000},"postexpandincludesize":{"value":4402,"limit":2097152},"templateargumentsize":{"value":2621,"limit":2097152},"expansiondepth":{"value":8,"limit":40},"expensivefunctioncount":{"value":0,"limit":100},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":2227,"limit":5000000},"timingprofile":["100.00% 12.839 1 -total"," 42.48% 5.454 1 Template:Tip"," 21.76% 2.794 2 Template:AmboxNew"," 15.86% 2.036 1 Template:Ns"," 10.27% 1.318 2 Template:Clear"," 9.97% 1.280 2 Template:Rarr"," 9.22% 1.184 1 Template:Warning"," 7.55% 0.969 1 Template:Icon"," 7.41% 0.951 5 Template:-"]},"cachereport":{"timestamp":"20241117205152","ttl":86400,"transientcontent":false}}});mw.config.set({"wgBackendResponseTime":211});});</script> </body>  </html>