Manual talk:LocalSettings.php

Jump to: navigation, search


The following discussion has been transferred from Meta-Wiki.
Any user names refer to users of that site, who are not necessarily users of (even if they share the same username).

Basic question *HOW* to edit!?[edit | edit source]

It's assumed here, in the documentation of LocalSettings.php, that the readers knows where this file is.

It would be kinda helpful if the documentation told me that.

You might think that "gee, if you need to edit LocalSettings then surely you know where it was installed." But that is not the case. In my case (just as one example) I have had a mediawiki installed for me on a hosted serverr.

Now the first thing I want to do is change $wgLogo. It's proving hard to do...

How to change $wgLogo:
  1. you have to edit the file LocalSettings.php which will be in the main directory of you wiki-installation
    • always good to do: copy the original LocalSettings.php to LocalSettings.php.backup (just in case)
    • change the value of $wgLogo
  2. activate the changes (just hitting the refresh-button doesn't help always. Probably depending on the browser settings...)
    • hit the refresh-button in you browser. You might also have to delete the cache to make the changes visible!

I have a question: I'm on my wiki. How can i reach the file and what i need to do to edit it? -20eric06

LocalSettings.php is not editable from the wiki (probably because this would create massive security risks). To edit this kind of file, you need a way to edit files on your server's file system. Evidently, the authors of the LocalSettings.php help assume the reader is the same person who installed MediaWiki on a given server. If you have the skills to get through Help:Installation, then you have the skills to edit any of the setup files such as LocalSettings.php. Obviously this assumption fails for the potentially large class of MediaWiki sysops who hired a Web hosting service to install MediaWiki for them. If you hired someone else to install MediaWiki for you, then you are left with no obvious way to get at LocalSettings.php, that is if you rely on the MediaWiki documentation as your only information source.
The situation is not entirely hopeless, because every Web hosting service must provide some way for the customer to change files on the server. To find out the method(s) you can use, contact your Web hosting service or look on their Web site for documentation. The details will vary from one service to another, but every hosting service customer needs to change files on the server, somehow, so any competent service will tell you how they let you do this. Here are some methods your service might use:
Note: something like my explanation above probably belongs in a help page here aimed at MediaWiki sysops who had a Web hosting service install MediaWiki for them. — Teratornis 17:39, 7 September 2006 (UTC)
If you hire a Web hosting service to install MediaWiki for you, you might benefit from also installing MediaWiki on your own Windows computer, so you can experiment with customizing it. It would probably be cheaper to prototype with your own MediaWiki install, where you won't be getting billed by the hour; then when you know exactly what to change, you can contact your Web hosting service to see about making the same changes on their server. If you learn what is going on behind the wiki interface, things like LocalSettings.php will make more sense. Teratornis 20:27, 7 September 2006 (UTC)

help[edit | edit source]

How can i get to "My LocalSettings.php"?--w:User:the editor1

Location and rights[edit | edit source]

I have two LocalSettings.php -files, one located at ./ and another at ./includes/. Which one's the one to edit? Furthermore, what rights should the file have? At the moment, no changes I make result in any changes. The mode is at 660 (I don't have the rights to change the mode). Thanks for any answers 09:25, 16 May 2006 (UTC)

Help[edit | edit source]

How do I edit LocalSettings.php? My Wiki's address is (there's no "wiki" in articles, so an article would be at The question is: where is that file? --Smiddle

You should ask ElWiki themselves. There's an e-mail address on their front page, elwiki AT Zone-MR DOT NET; alternatively there may be some kind of support tool when you're logged into the site. I don't know, I'm afraid; I'm not registered on that site. RichF 16:34, 21 August 2006 (UTC)
I tried to enter, and I get the following message:
"This file is part of MediaWiki and is not a valid entry point"
I try to edit it,, and I'm only editing a regular article called LocalSettings.php.
Edit: I tried /includes/LocalSettings.php, and it redirects me to an article called 403.shtml. I can just say one thing: I'M A NOOB --Smiddle 19:43, 1 September 2006 (UTC)
LocalSettings.php is a file on the filesystem that you need to edit. It's not a wiki article, or something you can edit through the wiki site itself. You need to be able to modify the file on the server itself. I don't know if ElWiki allow you to edit LocalSettings.php, and if they do, I don't know how. You will need to e-mail the people who run the site. Sorry. RichF 19:49, 1 September 2006 (UTC)
oh snap. I'll try that then. --Smiddle 19:52, 2 September 2006 (UTC)

Found Localsettings.php but cannot edit[edit | edit source]

I found locasettings.php at /wikis/config it was one of only three files in the folder. However, I am unable to edit it as it says it "Could not load LocalSettings.php. File not found". So I don't know where to go from there... I have created some wikis with no issue, however I can not change the source for the logo nor ad adsense code. Please help!!

``` Grant Beehler

Contact directly at

Where is this file?[edit | edit source]

I believe that if I find the LocalSettings.php file, I can translate all of the namespaces (currently in English) into my language wikipedia.

Unfortunately, no matter what I try, I cannot seem to locate this file.

I notice that many other people have asked this same question, but I have not found any answer.

See my comments above in Basic question *HOW* to edit!?. It sounds like you don't have access to the file system on the server that hosts your MediaWiki software. If you did, and if your server runs a Unix-like OS (which I believe is true for all the language Wikipedias), you could probably find your LocalSettings.php with a find command like this:
  • find / -iname 'LocalSettings.php' -print
If you need to prototype some complicated MediaWiki setup, you may be better off installing your own MediaWiki to practice with, and then when you know exactly what you want to change, contact your Web hosting service (which in this case sounds like it would be the system administrators for your language Wikipedia, that is, the people who have file system access to the servers rather than merely administrator access through the wiki interface). — Teratornis 03:42, 8 September 2006 (UTC)
  • find / -iname 'LocalSettings.php' -print was exactly what I needed. It's not a production server, just a test, so I can't do much harm. I just needed to know where to go. Thanks! -- 20:03, 24 September 2013 (UTC)

What do I have to do? The rest of the interface is mostly translated, only the namespaces are still in English. Thanks for anyone who can help. Codex Sinaiticus 07:10, 27 August 2006 (UTC)

Translated text, including namespace names, can be found in the languages/Language*.php files. Usually, if Wikipedia has been translated into a particular language, the namespaces will have been done at the same time. Which language are you translating into? RichF 22:06, 29 August 2006 (UTC)
I am the one who did the interface translation into Amharic myself, by modifying the Mediawiki files on that wikipedia over the past year as admin. But there is no way I can change the namespaces myself, that I know of.
  • Not via the wiki interface. You, or the people who run the server(s) that host the wikipedia you are describing, have to edit the LocalSettings.php file via the server's file system. Teratornis 03:42, 8 September 2006 (UTC)
On a related note, on the preferences, "amharic" (am) shows up as a choice for the interface only on the Amharic wikipedia.. It would be amazingly cool if this choice could be added with all the other languages for the other wikipedias, so that the Amharic interface I have designed could be used with any language wikipedia. Most of the small languages that are already available for interface on all the wikipedias in the preference section, are not even translated at all yet, and end up being English by default. Can you put a "bug" in some developer's ear about that? Thanks Codex Sinaiticus 15:30, 31 August 2006 (UTC)
Below is an excerpt from languages/LanguageFr.php, which is the French translation. This part of the file is providing French text for the namespaces. I haven't done a translation myself, but looking at this file, it does seem to be possible, and editing the LanguageXx.php file seems to be the way to do it. RichF 19:52, 1 September 2006 (UTC)
/* private */ $wgNamespaceNamesFr = array(
        NS_MEDIA                        => "Media",
        NS_SPECIAL                      => "Special",
        NS_MAIN                         => "",
        NS_TALK                         => "Discuter",
        NS_USER                         => "Utilisateur",
...several more lines like these...
        NS_HELP_TALK            => "Discussion_Aide",
        NS_CATEGORY                     => "Catégorie",
        NS_CATEGORY_TALK        => "Discussion_Catégorie"
) + $wgNamespaceNamesEn;

!!!H E L P!!!

Is it me or is this question simply *not* getting answered? Or maybe I'm in the Twilight Zone!!! I'm running *my own* MediaWiki install on *my own* Linux box and have access to everthing; everything, that is, EXCEPT 'LocalSettings.php'!!! Why? Because I can't find it either!!! I installed MediaWiki into username/public_html/wiki like a good boy. This is the 'main directory' referred to above. And it's *not* there!!! Did the find / -iname 'LocalSettings.php' -print thing too. Negatory maximus... Can someone please tell me where this @!#$ file is? I'm not too proud for a 'LocalSettings.php For Dummies'!!!

The LocalSettings.php file is created by the installer. Run the installer: visit your wiki with your browser (at http://localhost/wiki or whatever) and follow the instructions. When you are through, the last step is to move the freshly generated LocalSSettings.php to the right location, to make it go live. You can edit it before or after moving, as you like. -- Duesentrieb 22:14, 9 May 2007 (UTC)

KenPem -- I'm also running MW on my own Linux box, and there's no tract of this file. Very odd, as I assume (please correct me if wrong) that the Wiki won't work without it. Should I just create one?

Editing LocalSettings.php[edit | edit source]

Can it only be edited by the site owner or can Sysops edit this as well, I ask because I am a Sysop on a wiki that seems to have been deserted by its creator 20:48, 15 October 2007 (UTC)

It's a file. You need direct access to the files on the webserver to edit it. -- Duesentrieb 21:56, 16 October 2007 (UTC)

I downloaded a MediaWiki and started one on a webhost (with FTP and everything if that helps). I successfully installed it and I want to access LocalSettings.php, but there are no instructions on how to access it to edit it. I went to the file manager and went to it, but it says "This file is part of MediaWiki and is not a valid entry point." Can someone help me access it? I want to change the logo. Thanks, 00:33, 11 December 2007 (UTC)

Uh, help? 03:03, 13 December 2007 (UTC)
A good place to get help is Project:Support desk.
Anyway... it's a file, you would edit it like any file - how that is, depends entirely on how you generally access files, i.e. what exactly "FTP and everything" means (FTP is old and sucks, SSH would be good, but is not available for typical cheap-o webspace).
Anyway, if you get "This file is part of MediaWiki and is not a valid entry point" you are trying to view the file through the web server, executing the php. Which is not what you want. You probably want to download it, modify it, and then upload it again. How this is to be done, depends on whatever your "file manager" is. Ask your hosting people. -- Duesentrieb 14:04, 13 December 2007 (UTC)
Thank you. 09:09, 16 December 2007 (UTC)

I have a problem. I want to open up access for uploading files to my wiki. But I do not have to edit LocalSettings.php. If someone can send me to e-mail LocalSettings.php where I can see what needs to be changed and how. Thank you. 20:20, 16 January 2009 (UTC)

Back It Up[edit | edit source]

Make sure you back this file up. I recently had a power failure while uploading a modified version resulting in a 0 byte LocalSettings.php both local and remote. The only way I could find to restore the file was to reinstall the wiki and try to remember what had been changed. — Preceding unsigned comment added by (talkcontribs) 21:26, 5 November 2007

The following discussion has been transferred from Meta-Wiki.
Any user names refer to users of that site, who are not necessarily users of (even if they share the same username).

Latex Equations[edit | edit source]

I believe there are some missing steps in the Latex equations enabling instructions in this page.

I have miktex intalled and latex is in the path. I edited LocalSettings as explained but I still receive the message: Failed to parse (Missing texvc executable; please see math/README to configure.)

I have seen the file but still could not make it work. I think I should have texvc executable in the math directory, but I could not make "Make" works. Is there any texvc.exe already compiled for windows? --Fredguth 18:59, 7 July 2006 (UTC)

Thumbnails[edit | edit source]

Isn't $wgUseImageResize = true; also required for thumbnails? Is ImageMagick required or can MediaWiki's internal thumbnailer also be used? 06:43, 22 Jul 2004 (UTC)

Language[edit | edit source]

The wgEmergencyContact variable is the e-mail address of the user to contact if something goes wrong. This e-mail address is used to send internal bug reports to. As an administrator, you want to include your e-mail address here.

Linking to an external file[edit | edit source]

Is it possible to Link to a file on an external device? Like file:\\\\MyDocs\Letter.doc ?

(Newbie) 09 Jun 2005

yes -add file: protocol to the supported list in localSettings.php (the list definition may need to be copied from defaultSettings.php - never edit defaultSettings.php!) - bk

One user-db for multi mediaWiki's?[edit | edit source]

Hello, I will install multi mediaWiki's on my homepage, but i don't like that, the user must be regisrie/login of all my wiki's. How can/must be chance the LocalSettings.php to use one 'user'-DB?

I know/think must use

  • a one mySQL-IP (???.???.???.???)
  • a one mySQL-DataBase-Name (DB????)
  • a one mySQL-DataBase-Tabel for the user-name/-password ('user')
  • and for all wikis must set a prefix ('en_????', 'de_????', and so....)

Ok, but now? what must chance for all wikis? to use the 'user'-tabel in all wikis? How chance the prefix for 'user'-DB from 'en_user', 'de_user', ..... -> TO -> 'user' without a prefix for the 'user'-DB ?

Please can you write me onto my page discussion-page.

Thanks --FireDragon 21:03, 10 Jun 2005 (UTC)

OK, I have found m:Single login/IMSoP Now I have tempted to set the $wgSharedDB var in the LocalSettings.php, but I've got a mistake: ...(SQL query hidden)... Function "User::idFromName". MySQL ... Table 'db2000.de_user' doesn't exist (localhost)". Thats right, because I have rename the tabel 'de_user' to 'user' In the DefaultSettings.php is: > $wgSharedDB = null; < and I write in the LocalSettings.php > $wgSharedDB = "user" or $wgSharedDB = array('user') Please can anybody help me? I don't understand the var setting --FireDragon 10:46, 12 Jun 2005 (UTC)

Oki, I think I have found a Bug for this problem! see more on my user-page or Bug2396 atbugzilla:2396 --FireDragon 21:05, 12 Jun 2005 (UTC)

Installation Error[edit | edit source]

I am a total newbie trying to implement my first installation of MediaWiki. When I run the installer by pointing to the config folder I almost get an installation. But, I get the following output and have no idea where to go frem here or even if I am posting this at the right place in the right way. Here is the output and I am hoping someone can help me complete this installation:

  1. PHP 4.3.11: ok
  2. Warning: PHP's register_globals option is enabled. MediaWiki will work correctly, but this setting increases your exposure to potential security vulnerabilities in PHP-based software running on your server. You should disable it if you are able.
  3. PHP server API is apache; ok, using pretty URLs (index.php/Page_Title)
  4. Have XML / Latin1-UTF-8 conversion support.
  5. PHP is configured with no memory_limit.
  6. Have zlib support; enabling output compression.
  7. Turck MMCache not installed, can't use object caching functions
  8. Found ImageMagick: /usr/bin/convert; image thumbnailing will be enabled if you enable uploads.
  9. Found GD graphics library built-in.
  10. Installation directory: /mounted-storage/home5/sub004/sc12824-RFHO/www/freeflow/FFWiki
  11. Script URI path: /FFWiki

Fatal error: Undefined class name 'title' in /mounted-storage/home5/sub004/sc12824-RFHO/www/freeflow/FFWiki/includes/Setup.php on line 370

[edit | edit source]

The Logo section says to use the relative URL, however I had to use the full canonical URL... What gives?

  • <WHY> did you have to use the full URL? Maybe you were having the same problem I was... I think:
$wgLogo = "$wgStylePath/common/images/wiki.png";

Should be:

$wgLogo = "{$wgStylePath}/common/images/wiki.png"; 

and you need to define $wgStylePath not as "/var/www/html/wiki/skins/" (or whatever, that's the path from / on my machine), but as the URL path (and thanks to YOUR clue, whoever you are, I found that):

$wgStylePath = "/wiki/skins/"

This works like a charm for me, so I'm going to edit the Manual:LocalSettings.php so others with no previous knowledge of mediawiki setup will not be lead astray the way I was. Cheers!

-Tzf 02:02, 2 November 2007 (UTC)

Well, Tzf, I'm glad it works so well for you. Though I've been a wiki admin for quite a while, I never needed more than the old wikimedia interfaces before. Now my duties in developing a new wiki involve working with LocalSettings.php, and that setting sure screwed me up. I'm not touching the article because I know that I don't know enough to do it. Ever call in to tech support with a problem and hear "Well, it works all right on my machine"? -- Thnidu 19:02, 22 July 2009 (UTC)

After a couple of hours of tinkering with the LocalSettings.php file, resizing my logo.png to below 135 x 135 px, and reloading several times, I finally found out that I had done everything done correctly the second attempt. I just hadn't cleared by browser cache so it looked like I continued to fail. LFMF, and clear that cache. Greggem 00:31, 30 July 2011 (UTC)

Renaming site:Changing $wgsitename[edit | edit source]

I need to change $wgSitename var in the LocalSettings.php since is started with "MyWiki", but i created documents such as "MyWikipedia". If I change $wgSitename to "MyWikipedia", then all the articles starting with "MyWikipedia" disappear. I want to move the "MyWikipedia" to it's own name space - essentially the sitename. Help... :-) I have a bunch of documents with the namespace of "MyWikipedia:" that want to use as the site/project name. I'm using MediaWiki 1.5.5. -Mitch 21:20, 12 January 2006 (UTC)

  • I have a similar problem but maybe a bit trickier. My site's in German, I'd like to change the site's name to something that contains an Umlaut. Doing this in LocalSettings.php I end up with funny characters on the screen, as described elsewhere. (If anybody has a solution to this I'd be very happy.) Additionally, part of the pages disappear as Mitch describes. My approach would be to create a database dump and then reinstall the wiki with a new name, then import the dump. I havent tried it yet because I'd like to find a more elegant way to do this. Any hints? -- 02:40, 21 January 2006 (UTC)

rebuildMessages.php[edit | edit source]

Is there a possibility to use rebuildMessages.php with the browser? Changing messages was easier before... --Edi Goetschel 22:33, 11 November 2006 (UTC)

If done it with a re-installation of the Wiki... a bit clunky. --Edi Goetschel 22:52, 11 November 2006 (UTC)

Enabling subpages[edit | edit source]

This article isn't very specific about what should userd change in order to enable the subpages.

Should I copy paste the syntax $wgNamespacesWithSubpages[NS_MAIN] = 1; into LocalSettings.php? --T-man 21:03, 15 November 2006 (UTC)

  • Yes, that's the right way, T-man. See Sub-page#Administration for the list of namespace name abbreviations to use when adding lines similar to the one below in your LocalSettings.php file.
$wgNamespacesWithSubpages[NS_MAIN] = true;

 — MrDolomite | Talk 21:16, 15 November 2006 (UTC)

Enabling subpages for all namespaces[edit | edit source]

Is this correct:

# Enable subpages in all namespaces
$wgNamespacesWithSubpages = array_fill(0, 200, true);

I can't enable image uploads!![edit | edit source]

I'm a total newbie at MediaWiki, and I want to allow me and my users to upload images. But it seems like I messed up my installation. I tried editing localsettings.php, but the following shows up:

To enable image uploads, make sure the 'images' directory ## is writable, then set this to true: $wgEnableUploads = true;Error, Setup.php must be included from the file scope, after DefaultSettings.php

Please help me with this...

This error message occurs when "require_once( "$IP/includes/DefaultSettings.php" );" is not found. You may have commented or modified that line. The line should follow the "set include path" instruction and come before any changes in the default settings. Add all changes at the end of LocalSettings.php so that they can override what comes before (Defaults in this case). Pendare 06:02, 26 June 2011 (UTC)

To enable uploads add a line containing $wgEnableUploads = true; to the end of the LocalSettings.php file.Pendare 06:02, 26 June 2011 (UTC)

Should I save Localsetting.php as utf8 encoding ?[edit | edit source]

If I want to use some ExtraNamespaces in Chinese, I have to save Localsetting.php with utf8 encoding. But sometimes some error will occur, for example, the setting in common.css page will be desable and some functions will become unstable.

When I save it with other encoding, like big5 encoding, the ExtraNamespaces in Chinese will be unable.

Now, I save Localsetting.php in English and insert a line like followed:

require_once( "$IP/extensions/ExtraNamespace.php" ); 

The ExtraNamespace.php is a utf8 encoding file and the content of the file is the setting involved with ExtraNamespaces. Then all problems I've met will be solved.

Can I do it by this way? or I should not use any ExtraNamespaces in Chinese. But I've tried to set all ExtraNamespaces in English and change the file .\languages\messages\MessagesZh_tw.php, but I always failed. Perhaps I don't know how to edit the MessagesZh_tw.php. any ideas? --Roc michael 16:12, 13 July 2007 (UTC)

  • Mediawiki 1.9.2 and 1.9.3 in Chinese interface
  • OS windows server 2003
  • The AppServ Open Project - 2.5.7 for Windows
    • Apache Web Server Version 2.2.3
    • PHP Script Language Version 5.1.6
    • MySQL Database Version 5.0.24a
    • phpMyAdmin Database Manager Version


$wgNamespacesWithSubpages[NS_MAIN] = 1;[edit | edit source]

With mediawiki-1.9.3 it is :

$wgNamespacesWithSubpages = array(
      NS_MAIN             => true,
Activation on eo

Please activate subpages in Esperanto Wikipedia mainspace. Thx ArnoLagrange (sysop and bureaucrat @ eo:WP ) 09:05, 17 November 2007 (UTC)

Please ask it on bugzilla: SPQRobin 12:05, 17 November 2007 (UTC)
After a request on my talk page, I submitted bug 12338. SPQRobin 12:26, 18 December 2007 (UTC)

Questions. Please message me on my userpage if you have the answers[edit | edit source]

  1. My first question was answered in the question directly above.
  2. How do you make it so that redirects are italicized?
  3. If the extra namespaces is set like this:
    $wgExtraNamespaces = array(100 => "Portal", 101 => "Portal_talk");
    Then how do you figure out the code for the default, given namespaces?
    - This is impossible as there are no breaks in the numbers: Manual:Namespace.
  4. If I did add extra namespaces and I already had pages with that prefix would they be deleted? Like if I have a map called "Map:Krivoi Rog" and I add the "Map:" namespace will this page be deleted? - Answered and merged into article.

PatPeter 21:17, 9 October 2007 (UTC)

wgSpamRegex[edit | edit source]

This page of the manual ought to have a link to Manual:$wgSpamRegex, which is yet another setting in the LocalSettings.php file. (I would have already added it myself if the page wasn't locked). --DavidCary 23:08, 15 December 2007 (UTC)

Problem After Editing LocalSettings.php[edit | edit source]

On several occasions, I have have tried editing LocalSettings.php by adding "require_once" extensions toward the end (but before the >? characters). This was after uploading the correct php files to the correct directory. After saving, my wiki cannot load. There's no error message--there's just nothing there. It's blank. If I delete the line I added, the wiki comes back just fine. I've edited other variables and it's fine. Let me know if you have any suggestions for this issue. Thanks. Corsulian 01:01, 28 December 2007 (UTC)

Make sure that you are getting the correct variations of the Cite and ParserFunctions extension for your PHP version. I think Cite is fine, but the current version of ParserFunctions requires PHP 5 in order to run (and since you're running MediaWiki 1.6.10, I'm assuming you only have PHP 4). Try getting the other version of it and see if that works. And as for your logo, try changing $wgLogo to an absolute path to the image. --Skizzerz talk 15:14, 28 December 2007 (UTC)
Thank you. It does appear that I am stuck with PHP 4. I'll see if that changes things. As for the image, I am currently using the absolute path. I'm a little concerned that I can't find any reference to these issues from anyone else. I'm hoping that I'm not missing some enormous step in my configuration somewhere--I installed the wiki through one of those automated "here's a bunch of free programs you can use" modules through the admin panel that my host provides. Corsulian 16:25, 28 December 2007 (UTC)
Ok, you're setting the wrong path to the logo, which is why it's not appearing. Try $wgLogo = ""; instead (you were linking it to the image page, not the image itself). --Skizzerz talk 16:57, 28 December 2007 (UTC)
Thank you--fantastic. The logo is fixed and the ParserFunctions extension is installed. I was expecting it to fix a few issues I had with the NavBox template but no such luck--I'll look into that more. I haven't found a PHP4/5 differentiation with the Cite extension yet--the "blank" problem remains at least for now. I'll continue looking into it--please, anyone, let me know in the meantime if you have specific experience with Cite.php and PHP4. I'll look to the Cite.php discussion page for more details otherwise. Corsulian 21:40, 28 December 2007 (UTC)

Specific Details[edit | edit source]

  • MediaWiki 1.6.10
  • The two specific php lines I tried using:
    • require_once( "/extensions/Cite/Cite.php" );

**require_once( "$IP/extensions/ParserFunctions/ParserFunctions.php" );

Other, Possibly Related, Issues[edit | edit source]

*Unable to get my changed upper-left logo to appear. It is 135 pixels square and uploaded to the wiki itself with the path reflected in the LocalSettings.php. No logo at all is currently visible.

What has worked?[edit | edit source]

*I can upload files just fine.

Changes not taking effect[edit | edit source]

After editing and saving localsettings.php, none of my changes take effect. Am I missing some obvious (and unspecified!) step, such as stopping services before editing, or running a script after editing? If so, which service(s) need to be stopped and/or what script needs to be run? Bastun 10:23, 10 January 2008 (UTC)

No. All changes should take effect right away. Make sure you are not editing an unused copy, and that you put your changes near the end of the file. -- Duesentrieb 14:05, 12 January 2008 (UTC)
Details of the issue are discussed at Project:Support_desk --Zven 18:42, 12 January 2008 (UTC)

Need a fresh copy created with Wiki[edit | edit source]

We need a default copy of LocalSettings.php placed at Manual:LocalSettings.php/Default. So that if users screw up something it it, they can easily revert. -PatPeter, Tournesol.pngMediaWiki Support Team 19:56, 25 February 2008 (UTC)

But the "defaults" depend on all the values the user enters into the installation form.
The "real" defaults are in DefaultSettings.php. What is in LocalSettings.php really are local settings. So there is no default. -- Duesentrieb 22:00, 25 February 2008 (UTC)
Alright then let me rephrase what I meant, since I thought what you said would be assumed. We need a copy of LocalSettings that gives all the defaults, and where things like email and whatnot are concerned have ## this is a setting of your choosing. or whatnot. -PatPeter, Tournesol.pngMediaWiki Support Team 02:10, 26 February 2008 (UTC)
If we destroy the LocalSettings.php file, is the Mediawiki projet recreate it ? Phd0 06:55, 21 January 2009 (UTC)

Editing LocalSettings.php has created an error I can't get rid of.[edit | edit source]

I recently edited LocalSettings.php. After saving the changes, I tried to access my wiki, but it gave me an error. After receiving the error, I took out the aforementioned change. Now my wiki gives me a completely different error: Warning: Cannot modify header information - headers already sent by (output started at /etc/mediawiki1.10/LocalSettings.php:2) in /usr/share/mediawiki1.10/includes/WebResponse.php on line 10 whenever I try to save a page. The wiki will also display the same error on any of the wiki pages, at the top, where the header would be. The pages are still visible, except when someone tries to edit a page.

A "default" copy of LocalSettings.php would be apreciated. I know there is no default exactly, but I just need something that I can compare to my copy of LocalSettings, so I can see what is different and fix it. I realize that site names and such would have to be different, but that's not what I need to see, I just need something that has all the same variables and variable assignments as LocalSettings would when first installed.

Solution[edit | edit source]

  1. Probably there's some empty line or character before the <?php begins, or there's content behind the ?> --TheDevilOnLine 14:10, 8 May 2008 (UTC)
    • Remove all content (including spaces and empty lines) before the <?php (the < should be the first character in the document)
    • Remove the ?> and everything after it (if there's a ?> in your document)
  2. Also file was saved in encoding "UTF-8 with signature" --RazbakovAleksey 10:44, 4 March 2010 (UTC)
    • Open file in extended editor (like Notepad 2), chage encoding to "UTF-8" and save the file

Securing this file[edit | edit source]

Nowhere can I find instructions on the generally accepted way to secure LocalSettings.php. This file sits in my root directory and contains plaintext passwords. Do I just chmod 700? Is that the only level of security provided? It seems like an awfully big risk. If someone does know a generally recommended way to secure this file, it should be listed both on this page and on Manual:Installing MediaWiki. — Epastore 15:37, 28 May 2008 (UTC)

The php/web user needs to be able to access the password in order to contact that database. So, it can not be secured against access by that user. Encrpyting it in some way would just be obfuscation, since the means for decrypting would have to be available to that user too.
Since access by other users is prevented by the 700 access mode, I don't see a problem here. A second line of defense would be telling the database server to only accept connections from localhost or at least only the local lan. This is standard procedure and would prevent anattacker from accessing your database even if the password should be leaked.
I don't know, and can't think of, any other way for web applications to secure the passwords they used for accessing the databse. Its the same for a normal multiuser system: your database password sits in ~/.my.cnf as plain text and is protected against access by others only by the file's mode. -- Duesentrieb 16:08, 28 May 2008 (UTC)
So is that what you do, just change the posix permissions? I am looking for some sort of generally accepted practice. What does Wikimedia do?
Relying only on posix permissions seems to mean that if the server happens to have a hole (such as a newly discovered hole in php or apache for which there is not yet a patch), then my site could be effectively rooted. The most common exploits I see are "escalated privileges," i.e., breaking posix permissions.
And shouldn't this security practice be documented somewhere? The default installation leaves the database password open to anyone who can browse to that file, does it not? Or does the .php suffix act as a basic level of security?
As for the user needing the permission... it also means that anyone with ftp to the mediawiki directory can see the database password. Sometimes people are given ftp without being given full reign over the database, are they not?
These are genuine questions... I am a newbie and would love to be proven wrong about any of the above. :) — Epastore 21:36, 28 May 2008 (UTC)

One thing that you can do is create and use a limited database user. Add a single purpose user that only has access to the wiki database and grant it select, insert, update and delete permissions. I'm going over to add a note about this to Manual:Config_script so that it's at least listed somewhere accessible. — IvoLucien 20:05, 31 May 2008

Blank wiki main page - subtly corrupted LocalSettings.php[edit | edit source]

Originally this entry would been about a "Wiki has a problem" message, but I quickly realized that I had changed the mysql password that MediaWiki needed. After updating the database password in LocalSettings.php, my MediaWiki started coming up completely blank. The web server didn't log any errors, so kept looking and I finally found this in phperror.log:

[31-May-2008 18:51:33] PHP Warning: Unexpected character in input: '\' (ASCII=92) state=1 in C:\www\wiki\LocalSettings.php on line 3
[31-May-2008 18:51:33] PHP Warning: Unexpected character in input: '\' (ASCII=92) state=1 in C:\www\wiki\LocalSettings.php on line 4
[31-May-2008 18:51:33] PHP Parse error: syntax error, unexpected T_STRING in C:\www\wiki\LocalSettings.php on line 4

The strange thing is that the file looked fine, no stray characters. It turns out that the Visual Grep editor that I'd used to edit the password had somehow corrupted the line endings. Opening it in a clean text editor (not notepad, metapad in my case) and saving over top of the file fixed it. I found references online to this sort of thing happening on Macs as well.

Or perhaps the file had gone stale and needed to be aired out. Regardless, good luck! - IvoLucien - 31-May-2008 19:36:44

How do I get my domain name to work?[edit | edit source]

I have an add on domain set up in my cpanel to point to the wiki directory inside my root directory. What do I need to do for to open when the domain name is typed. When I type in I get the following error:

The requested URL /constitutionwiki/index.php5 was not found on this server.

That is the correct name (constitutionwiki) for the directory I have the mediawiki files in!

This is the path I see in the address bar:

The index.php5 file is there so what gives?

I have done searches and can't find anything that addresses this situation.

I am totally new to mediawiki!!

How to use interwiki images?[edit | edit source]

I want to use images on commons in my site. Is this possible. If yes how I can do that? -Redgwan 08:16, 23 August 2009 (UTC)

You should use Manual:Image_Administration#Foreign_Repositories. --Arseny1992 03:24, 28 November 2009 (UTC)

The Comment #UPO[edit | edit source]

Can anybody tell my what thet Comment want's to point out? I found it in multiple locations in the LocalSettings.php for example:

$wgEnableUserEmail  = true; # UPO

I couldn't make sense of it. (and it probably is not important, since it is a comment) -- 16:13, 4 November 2009 (UTC)

It actually says what it means in the file: “UPO means: this is also a user preference option” --ucc 11:17, 11 November 2009 (UTC)

MyWiki[edit | edit source]

What can I do to fix this? I copied alot of the DefaultSettings.php into LocalSettings is that bad? 21:23, 12 January 2010 (UTC)

<LocalSettings snipped>

Install Extension:ParserFunctions -- Bryan (talk|commons) 22:02, 12 January 2010 (UTC)
Thank you Bryan it worked. :) 10:10, 13 January 2010 (UTC)

What type of text editor to use?[edit | edit source]

It says, "Don't edit this file with Notepad or other text editor that adds byte order marks to files, or you will break your wiki." What is a better text editor to use? Metapad? Tisane 02:40, 24 February 2010 (UTC)

In reference to this edit, I understand the concern about advertising any particular software, but it would be a useful service to site administrators to provide some guidance as to what text editors are safe. Of course, we can't include a bunch of software names on the LocalSettings.php page, but maybe a link could be provided to a list of suitable and unsuitable text editors? Tisane 22:46, 1 March 2010 (UTC)
I wish they were more specific about what the problem is. I've used Notepad to edit LocalSettings.php for use on both windows and linux installations and have never had it create a problem. --Jerry Fallon 22:32, 13 October 2010 (UTC)
Any php editor would work Natkabrown (talk) 11:47, 29 May 2013 (UTC) - with help of Yaron Koren

GNU Licence[edit | edit source]

A wiki i am setting up wishes to go under a GNU License, in order to prevent similar wikis at Wikia from stealing content. Is this advisable? if so, what settings do i need to set in order to run a GNU-licensed wiki? thanks Bud0011 18:29, 24 February 2010 (UTC).

Activating the code[edit | edit source]

How do you activate the code once you have configured it so that it works on wikis? Is there also a way to use this on non-wikimedia wikis, such as WiiBrew? Keyboard mouse 01:02, 18 June 2010 (UTC)

I want to remove the square brackets on edit links[edit | edit source]

I'd like to set my edit links to be denoted with CSS styling (which I have done: span.editsection {

       -moz-border-radius: 2em;
       -webkit-border-radius: 2em;
       border-radius: 2em;
       border: 1px solid white;

} )

However the square brackets in the [edit] links makes this look terrible. I want them gone. I don't see a preference for this, and I cannot easily find where in what file adds these in. Any clues? 19:05, 1 July 2010 (UTC)

$wgGroupPermission BEFORE OR AFTER extension calls?[edit | edit source]

Hope I'm i the right place to ask this. Would like to know what the correct order is between $wgGroupPermission and extension require/include_once calls? Should the permission be granted before the extension is loaded? Or vice cersa?

Which of these two is correct:
$wgGroupPermissions['group' ]['function' ] = true;
$wgGroupPermissions['group' ]['function' ] = true;

OR does it matter? I have been testing both orders and either seems to work but some extension authors insist one order while another author wants it the opposite. 'Put mine first', 'Put this last'. I just want to know how the MW core system wants. And if every author wants their stuff last what then? Confused 06:16, 11 March 2011 (UTC)

Comments[edit | edit source]

The comment signs in the default localsettings.php are # or ##, is there any reason for this? It seems to me // or /*...*/ works too, but can this make any problems? --Lastwebpage 14:50, 22 April 2011 (UTC)

Comments in PHP are delimited by #, // or /* ... */, there should be no difference with any of these three methods. iAlex 15:13, 22 April 2011 (UTC)

Help[edit | edit source]

I'm working on setting up a wiki for a website and need to know a few things. I am not the person who installed the wiki, but I need access to the localsettings.php. Is there a way that by setting up a wiki-family? that I can gain the ability to edit this? A commonsettings.php? Also, the common.css files are not accessible to me either, although I have b'crat access on the wiki. Must this be changed in the localsettings.php so I can customize our skin? Bonzi - 17:49, 2 July 2011 (UTC)

Terms of Use[edit | edit source]

I try to find out since months how to add the "; additional terms may apply. See Terms of Use for details." phrase. What I have to do to get this text too? -- 12:15, 2 November 2011 (UTC)

Edit MediaWiki:Copyright on your wiki and add it to the existing text. Reach Out to the Truth 19:37, 3 November 2011 (UTC)
Thanks for your advice, but it doesn't work for me. MediaWiki's MediaWiki:Copyright has a different text too. -- 22:36, 3 November 2011 (UTC)
Yes, it has different text on this wiki. That's because Wikimedia sites override that message with a completely different message. The message isn't used on this wiki, but by default it is. If your wiki is public, can you post a link so I can take a look? Reach Out to the Truth 20:26, 4 November 2011 (UTC)
Ok, my bad. The text is changed, but I can't define the reference to $2. I have to use two links (like MediaWiki)-- 15:32, 5 November 2011 (UTC)
$1 is replaced by a link to $wgRightsPage or $wgRightsUrl with the text of $wgRightsText. $2 is not replaced by anything. So yes, you need to put the link in the message manually. Reach Out to the Truth 15:49, 5 November 2011 (UTC)

Update outdated information[edit | edit source]

The page is currently protected so that I cannot change it myself. It says:

Do not place extensions before the require_once( "includes/DefaultSettings.php" ); line; that will blank the extension setup function arrays, causing no extensions to be installed, and probably making your wiki inaccessible.

However, this is only right for MediaWiki 1.16 and older. Since MW 1.17, DefaultSettings.php no longer has to be included in LocalSettings.php instead.

It would be great, if someone could update that!

YesY Done Thanks! MrBlueSky 22:27, 13 January 2012 (UTC)

There's also a broken link. Change the link from to — 06:43, 8 March 2012 (UTC)

YesY Done Thank you! MrBlueSky (talk) 11:33, 8 March 2012 (UTC)

LocalSetting.PHP Edit crashes my Wiki[edit | edit source]

So i have access to the server file and simply wanted to change the All user rights in the localsettings.php file, but as soon as i make any changes and save them. The wiki no longer works and i get a Http 500 internal error. Am i missing something out?

You either had a syntax error or you used Notepad.--Jasper Deng (talk) 16:11, 18 June 2012 (UTC)

No title[edit | edit source]

It said "Don't edit this file with Notepad, TextEdit, or other text editor that adds byte order marks to files, or you will break your wiki." so what can I use to edit it?--一個正常人 (talk) 12:28, 26 September 2012 (UTC)

Notepad++ and Vim are both good options.--Jasper Deng (talk) 15:14, 26 September 2012 (UTC)
Thanks.--一個正常人 (talk) 08:57, 28 September 2012 (UTC)
Haha, that's funny. One of the reasons I avoid Notepad++ like the plague is that when I've used it to edit simple ASCII files in the past, it screwed the file up by changing the encoding. I have used notepad ever since and it left my ASCII files as ASCII (Windows XP and Windows 7).
But for LocalSettings.php it's optimal. For one thing it doesn't insert byte-ordering marks (I learned this the hard way on my first attempt at installing MediaWiki myself).--Jasper Deng (talk) 21:42, 24 November 2012 (UTC)

Problem with installer[edit | edit source]

After walking through the installation, I get the "Complete!" page, telling me that I have successfully installed mediawiki.

The installer has generated a localsettings.php file.

The download offered, and the link on the page throws this error, however:

"Internet Explorer cannot download index.php from localhost. Internet Explorer was not able to open this Internet site. The requested site is either unavailable or cannot be found. Please try again later."

Restarting the installation results in same answer. Without this file I can't get into my wiki because it believes it to be unconfigured.


HTTP Error 500 when LocalSettings.php permission set to 600[edit | edit source]

I've migrated a site to a new host and domain. Everything went perfectly and the site is working, except.. The permissions for LocalSettings.php when I moved everything across defaulted to 744. When I changed them to 600 to secure the site it stopped working with a HTTP 500 error.

this is some bs[edit | edit source]

how do you removed this? "MediaWiki internal error. Exception caught inside exception handler." and "Fatal exception of type MWException" it has stopped me from editing wikipedia.. what did i do to make this happen? i do the same things every day? how can i fix this??? DaHuzyBru (talk) 05:00, 28 June 2013 (UTC)

consequences of disabling $wgNamespacesWithSubpages after having it be enabled[edit | edit source]

I want to disable the feature of $wgNamespacesWithSubpages so that it will not apply one of my nav templates to subpages. I am worried that it will have more of an effect on my wiki then I care to deal with. Are there any major consequences/issues that will occur if i disable $wgNamespacesWithSubpages after having it be enabled for the entires wiki's life?

Check user permissions before loading extension[edit | edit source]

Hello. I was wondering if there is a possibility to check the permissions of a wikiuser inside LocalSettings.php and depending on the outcome load an extension? Now we are using the below code, this works fine when the wikiuser uses the same laptop or computer all the time but that is often not the case.

$remhost = array("laptopname1", "computername2");
if (in_array($_SERVER["REMOTE_HOST"],  $remhost )) {

If possible, we would like to check if a wikiuser is member of a group like the sysop's and only then load extensionx. If the user is not part of the sysop group the extension is not loaded. Then it does not matter on which computer or laptop the user is working. Regards, --Jongfeli (talk) 07:32, 14 August 2013 (UTC)

Help needed to repair localsettings.php[edit | edit source]

Hi all

I need help repairing my localsettings.php after accidentally using notepad to edit it (adds byte order marks to file), please could the answer be in baby steps, I'm very new to this. Currently it's just giving me a blank page rather than the wiki I've been working on.

Many thanks

Mrjohncummings (talk) 13:06, 21 August 2013 (UTC)

LocalSettings.php[edit | edit source]

After upgrading my wiki to 1.22.4 I recieved the error notice: "Warning: require_once() [function.require-once]: It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected 'UTC' for 'UTC/0.0/no DST' instead in /home/dorotinf/public_html/wikigenia/includes/GlobalFunctions.php on line 2300

Parse error: syntax error, unexpected $end, expecting T_VARIABLE or '$' in /home/dorotinf/public_html/wikigenia/includes/GlobalFunctions.php on line 2300"

This looks like something in my file LocalSettings.php is incorrect. where can I find a default LocalSettings.php to install in my wiki to see if it wors correctly? Please help. — Preceding unsigned comment added by Noham100 (talkcontribs)

Discussed here: Thread:Project:Support desk/Upgrade Wiki from 1.18 to 1.22.4 (2). Note that this talk page is not for resolving issues with private installations. --Ciencia Al Poder (talk) 10:31, 5 April 2014 (UTC)