Difference between pages "Package:MediaWiki" and "Main Page"

From Funtoo
(Difference between pages)
Jump to navigation Jump to search
m (Undo revision 10003 by Threesixes (talk))
 
m (Added linkedin and jira buttons)
 
Line 1: Line 1:
{{Ebuild
{{DISPLAYTITLE:Funtoo Linux}}
|CatPkg=www-apps/mediawiki
__NOTITLE__
|Maintainer=Drobbins,
__NOEDITSECTION__
|Repository=Funtoo Overlay
<div style="display: none;"><h1>Welcome to Funtoo Linux</h1></div>
}}
{{Fancyimportant|1=
This page documents how to install MediaWiki from source tarball rather than portage, which is the preferred method. It also shows how to use MediaWiki with php-5.4. As of late 1.22 and 1.23, MediaWiki now unofficially works with php-5.5 & php-5.6.}}
 
MediaWiki is a [[Web-server-stack]] web application.  This page documents how to set up MediaWiki on Funtoo Linux, from a bare stage3 install with network connectivity. We will use Nginx, xcache and PHP-FPM, which will result in good performance. We will also properly secure MediaWiki, and also cover some additional tips and tricks, focusing on spam reduction.
 
== Portage Settings ==
 
Add the following line to <code>/etc/[[make.conf]]</code>:
 
 
<pre>
PHP_TARGETS="php5-4"
</pre>
 
Add the following lines to <code>/etc/portage/package.use/php</code>:
 
<pre>
dev-lang/php curl exif fpm gd mysql mysqli sockets suhosin threads intl xmlreader xmlwriter
>=dev-php/xcache-2.0.0 php_targets_php5-4
</pre>
 
== Emerge ==
 
Emerge xcache, and we'll also emerge metalog and postfix. This should pull in MySQL as well as php-5.4:


<console>
<div class="row">
# ##i##emerge --jobs xcache metalog postfix
</console>


== Start and Configure Services ==
<div class="col-xs-12 col-md-3">[[File:Fwiki.png|link=Funtoo_Linux_Installation]]


Time to configure MySQL with a root password, start it, secure it, and enable it to start at boot. We'll also start metalog and postfix:
<!-- button block -->
<div class="row" style="margin-top:10px">
<div class="col-xs-3">[http://webchat.freenode.net/?nick=Funtoo.&channels=%23funtoo&uio=MTA9dHJ1ZSYxMj10cnVlf5 <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-comment"></i>]</div>
<div class="col-xs-3">[http://git.funtoo.org <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-code-fork"></i>]</div>
<div class="col-xs-3">[https://bugs.funtoo.org <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-bug"></i>]</div>
<div class="col-xs-3">[[Funtoo_RSS_and_Atom_Feeds | <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-rss-square"></i>]]</div>
</div>
<div class="row" style="margin-top:10px">
<div class="col-xs-3">[https://www.linkedin.com/company/funtoo-technologies <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-linkedin"></i>]</div>
<div class="col-xs-3">[https://www.facebook.com/pages/Funtoo-Linux/107461849335837 <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-facebook"></i>]</div>
<div class="col-xs-3">[https://twitter.com/funtoo <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-twitter"></i>]</div>
<div class="col-xs-3">[https://plus.google.com/+funtoo/posts <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-google-plus"></i>]</div>
</div>
<div class="row" style="margin-top:10px">
<div class="col-xs-3">[https://www.reddit.com/r/funtoo <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-reddit">r</i>]</div>
<div class="col-xs-3">[https://github.com/funtoo <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-github"></i>]</div>
<div class="col-xs-3">[https://www.youtube.com/channel/UCKmOY6p3c9hxv3vJMAF8vVw <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-youtube"></i>]</div>
<div class="col-xs-3">[http://distrowatch.com/table.php?distribution=funtoo <i style="border: 1px solid #1111a1;border-radius: 3px;" class="btn btn-block btn-custom fa fa-linux"></i>]</div>
</div>


<console>
<!--end of button block-->
# ##i##emerge --config mysql
# ##i##rc-update add mysql default
# ##i##rc-update add metalog default
# ##i##rc-update add postfix default
# ##i##rc
# ##i##mysql_secure_installation
</console>


== Database Setup ==
== Getting Started ==
'''[[Funtoo Linux Installation|Install Funtoo]]'''


Now, let's create a database named <code>mediawiki</code> for use by MediaWiki, and a <code>mediawiki@localhost</code> user to access this database, using a password of <code>wikifever</code>:
'''{{CreateAccount}}''', which allows you to get involved with the community.  Log in to the [http://www.funtoo.org/ wiki], [http://forums.funtoo.org forums], and [https://bugs.funtoo.org bug tracker] under the same username, and password by unified logins.  See the [[Funtoo Authentication FAQ|Auth FAQ]] & [[Funtoo Linux FAQ|General FAQ]].


<console>
'''[[Reporting Bugs|Report bugs, and suggest improvements]]''' to our '''[http://bugs.funtoo.org bug tracker]'''. We take all bugs seriously, and all work performed is tracked on our public bug tracker, for purposes of transparency.
# ##i##mysql -u root -p
See the [[Funtoo Linux FAQ]].
Enter password:  
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 7
Server version: 5.1.62-log Gentoo Linux mysql-5.1.62-r1


Copyright (c) 2000, 2011, Oracle and/or its affiliates. All rights reserved.
</div>


Oracle is a registered trademark of Oracle Corporation and/or its
<div class="col-xs-12 col-md-9">
affiliates. Other names may be trademarks of their respective
Funtoo Linux is a rolling-release Linux meta-distribution for x86 and ARM systems. It uses Portage as a package manager, and is run by Daniel Robbins, creator of Gentoo Linux. It is a continuation of Daniel's work on Gentoo Linux.  Funtoo Linux is committed to software freedom, independence, and a user-centric model of software development, where our users help define the future direction of the project.
owners.


Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
Our goal is to provide a best-of-breed Gentoo-based meta-distribution that is ideal for desktop and servers, and to progressively improve our core technology in thoughtful and innovative ways, while respecting Gentoo design principles, and the history of Unix and Linux.


mysql> ##i##create database mediawiki;
Funtoo Linux provides [[Subarches|optimized builds]] for your specific hardware to ensure the best possible performance, and offers the following features:
Query OK, 1 row affected (0.01 sec)
* A completely systemd-free system, including GNOME 3.14 without systemd.
* A new [[Funtoo 1.0 Profile|profile system]] to simplify system configuration.
* Improved ease of install with pre-built Debian kernel provided in our install image.
* A new system configuration tool, [News:Better_Experiences:_Ego_and_Vim ego].
* An advanced build and quality assurance tool called [[Metro]], providing optimized install images and enhanced real-world testing.
* The use of git as a default mechanism for getting updated ebuilds (build scripts) to you.
* [[Funtoo Linux Networking|Modular networking scripts]] to simplify creating sophisticated server network configurations.
* Enhanced Python support from the Progress overlay, and inclusion of other popular packages from the Gentoo ecosystem.


mysql> ##i##grant index, create, select, insert, update, delete, alter, lock tables on mediawiki.* to 'mediawiki'@'localhost' identified by 'wikifever';
</div>
Query OK, 0 rows affected (0.01 sec)


mysql> ##i##\q
<div class="col-xs-12 col-md-9">{{Announce|{{SupportBlurb}}}}</div>
Bye
#
</console>


== Nginx Setup ==
<div class="col-xs-12 col-md-5">
=== News ===
{{NewsList|2}}
</div>


We will use nginx as our Web server. Let's emerge it:
<div class="col-xs-12 col-md-4">
== Official Projects ==
*  '''[[Keychain]]''', an SSH/GPG agent front-end.
* '''[[Metro]]''', automated Funtoo build engine.
* '''[[Linux_Fundamentals,_Part_1|Learn Linux]]'''! [[Awk_by_Example,_Part_1|Awk]], [[Bash_by_Example,_Part_1|Bash]], [[Sed_by_Example,_Part_1|Sed]]  and more.
* Web projects include [http://larrythecow.org larrythecow.org], the Gentoo blog aggregator, and [http://kernel-seeds.org kernel-seeds.org].


<console>
=== [[Ebuilds]] ===
# ##i##emerge --jobs nginx
'''Ebuild pages recently updated:''' {{#ask: [[Category:Ebuilds]]
</console>
| order=descending
 
| sort=Modification date
== User and Group ==
| format=list
 
| limit=10
When we run our wiki, we will run it as the <code>docs</code> user, for security. Let's set up a <code>docs</code> user and group:
| searchlabel=
 
<console>
# ##i##groupadd docs
# ##i##useradd -g docs --home /home/docs docs
# ##i##install -d /home/docs
# ##i##chown -R docs:docs /home/docs
</console>
 
== Set up PHP ==
 
As our last major configuration step, we will configure the PHP FastCGI Process Manager by creating a <code>/etc/php/fpm-php5.4/php-fpm.conf</code> file with the following contents (existing contents can be deleted):
 
{{file|name=/etc/php/fpm-php5.4/php-fpm.conf|desc= |body=
[global]
error_log = /var/log/php-fpm.log
log_level = notice
 
[docs]
listen = /var/run/docs.php-fpm.socket
listen.allowed_clients = 127.0.0.1
listen.owner = docs
listen.group = nginx
listen.mode = 0660
user = docs
group = docs
pm = dynamic
pm.max_children = 16
pm.start_servers = 2
pm.min_spare_servers = 2
pm.max_spare_servers = 2
pm.max_requests = 500
php_admin_value[open_basedir] = /home/docs/public_html:/tmp
php_admin_value[error_log] = /home/docs/php-errors.log
php_admin_value[disable_functions] = exec, system, shell_exec, passthru, popen, dl, curl_multi_exec, posix_getpwuid,
disk_total_space, disk_free_space, escapeshellcmd, escapeshellarg, eval, get_current_user, getmyuid, getmygid,
posix_getgrgid, parse_ini_file, proc_get-status, proc_nice, proc_terminate, suexec, pclose, virtual, set_time_limit, show_source
}}
}}
This configuration file tells PHP to use the <code>docs</code> user when running MediaWiki. '''Please note that the last line is very long - I have split it into 3 lines for readability on this wiki, but you should combine them into a single line in your configuration file. The line should start with <code>php_admin_value[disable_functions]</code> and end with <code>show_source</code>.
</div>


== Configure Nginx ==
</div>


Oh! Now we need to configure nginx to serve pages as the docs user. Assuming your site is named wiki.mysite.com, create a <code>/etc/nginx/sites-available/wiki.mysite.com</code> file with the following contents:


<pre>
server {
        listen 80;
        server_name wiki.mysite.com;


        access_log /var/log/nginx/wiki.mysite.com.access.log main;
<div class="row">
        error_log /var/log/nginx/wiki.mysite.com.error.log error;
  <div class="col-md-6">{{#widget:YouTube16x9|playlist=PL2YVrx9jFJOewYI7f15FahwLOZlFCRqjZ}}
       
{{FuntooFriendly|Brownrice Internet}}
        root /home/docs/public_html;
</div>
        index index.html index.php;
</div>


        # uncomment this if you want to htpasswd-protect your site while you set it up initially
{{#seo:
        # auth_basic "Ninjas allowed only";
|title=Funtoo Linux
        # auth_basic_user_file /etc/nginx/docs.funtoo.org.htpasswd;
|keywords=funtoo,linux,gentoo,Daniel Robbins
 
|description=Funtoo Linux is a Gentoo-based OS that uses a git-based Portage tree. Run by Daniel Robbins, creator of Gentoo.
location ~* ^(.*)(install.php|LocalSettings.php|\.git) { deny all; }
 
location ~* \.php$ {
        #set $https "off";
        #if ($scheme = https) { set $https "on"; }
        #fastcgi_param HTTPS $https;
 
        try_files      $uri    @404;
        fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
        fastcgi_param  SERVER_SOFTWARE    nginx;
        fastcgi_param  QUERY_STRING      $query_string;
        fastcgi_param  REQUEST_METHOD    $request_method;
        fastcgi_param  CONTENT_TYPE      $content_type;
        fastcgi_param  CONTENT_LENGTH    $content_length;
        fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
        fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
        fastcgi_param  REQUEST_URI        $request_uri;
        fastcgi_param  DOCUMENT_URI      $document_uri;
        fastcgi_param  DOCUMENT_ROOT      $document_root;
        fastcgi_param  SERVER_PROTOCOL    $server_protocol;
        fastcgi_param  REMOTE_ADDR        $remote_addr;
        fastcgi_param  REMOTE_PORT        $remote_port;
        fastcgi_param  SERVER_ADDR        $server_addr;
        fastcgi_param  SERVER_PORT        $server_port;
        fastcgi_param  SERVER_NAME        wiki.mysite.com;
 
        fastcgi_pass    unix:/var/run/docs.php-fpm.socket;
        fastcgi_index  index.php;
}
 
# this will secure the MediaWiki uploads against arbitrary PHP injection attacks:
location /images/ {
        location ~.*\.(php)?$ {
                deny all;
        }
}
 
 
location @404 {
        return 404;
        break;
}
 
location / {
        try_files $uri $uri/ @mediawiki;
}
 
location @mediawiki {
        rewrite ^/([^?]*)(?:\?(.*))? /index.php?title=$1&$2 last;
}
 
}
</pre>
 
for localhost/wiki/ short urls in nginx:
{{file|name=/etc/nginx/sites-enabled/localhost|lang=|desc=domain.com/wiki/ short urls|body=
location /wiki {
index index.php;
rewrite "^(wiki)$" $1/ permanent;
rewrite "^/?wiki(/.*)?" /mediawiki/index.php?title=$1&$args last;
}}
}}
== Enable Ngnix and PHP-FPM ==
Now, let's enable nginx to serve our site, and also be sure to enable php-fpm:
<console>
# ##i##cd /etc/nginx/sites-enabled
# ##i##ln -s ../sites-available/wiki.mysite.com wiki.mysite.com
# ##i##rc-update add nginx default
# ##i##rc-update add php-fpm default
# ##i##rc
* Starting PHP FastCGI Process Manager ...                                                            [ ok ]
* Starting nginx ...                                                                                  [ ok ]
#
</console>
== MediaWiki from portage ==
There are mediawiki ebuilds in portage, if you like your site breaking upon emerge --sync && emerge -avuND world:
<console>###i## emerge mediawiki</console>
With out the vhost flag the files will be dropped into /var/www/localhost/htdocs/mediawiki.
== Download MediaWiki ==
We're getting close. Now, head to http://www.mediawiki.org/wiki/Download and copy the link address for the latest version of MediaWiki, currently 1.19.1 at the time this was written. Let's download the archive to <code>/var/tmp</code>:
<console>
# ##i##cd /var/tmp
# ##i##wget http://download.wikimedia.org/mediawiki/1.19/mediawiki-1.19.1.tar.gz
</console>
== Extract MediaWiki ==
We now have all the Web, database and email infrastructure enabled that we need. Heading to the IP address of your server should result in a 404 - Not Found error in your Web browser. Time to extract and configure MediaWiki itself:
<console>
# ##i##su docs
$ ##i##cd /var/tmp
$ ##i##tar xvf ./mediawiki-1.19.1.tar.gz
$ ##i##mv mediawiki-1.19.1 ~/public_html
</console>
== MediaWiki from GIT ==
Alternatively, we can download the code from the git repository:
<console>
# ##i##su docs
$ ##i##cd ~
$ ##i##git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git public_html
</console>
Specific stable versions of MediaWiki are tracked using 'tags'. These are analogous to the tarball releases. We can see the versions available with:
<console>
$ ##i##cd public_html
$ ##i##git tag -l | sort -V
</console>
To use a specific tag (1.19.1):
<console>
$ ##i##git checkout 1.19.1
</console>
== Initial Web Config ==
You will now be able to load the URL of your server in your Web browser and configure MediaWiki through the Web user interface. Complete the '''full''' installation process and be sure to specify that you are using XCache for caching. Once you go through this process, the Web installation process will provide you with a <code>LocalSettings.php</code> file, which you should place in <code>/home/docs/public_html</code>. The <code>LocalSettings.php</code> file can also be manually edited and used to enable MediaWiki features and extensions.
== Tips and Tricks ==
=== Alternate Main Page ===
To define your default landing page for mediawiki.
edit: localhost/wiki/MediaWiki:Mainpage
example: http://www.funtoo.org/MediaWiki:Mainpage
=== Arbitrary Page Titles ===
To change a page's title from domain.com/Main_Page to "title" insert this magic word in the page:
*<nowiki>{{DISPLAYTITLE:title}}</nowiki>
=== Show Php handler, Database & Plugins Used ===
To show which plugins are installed on a wiki, browse localhost/wiki/Special:Version.
example: http://funtoo.org/Special:Version
=== Sidebar ===
To define your own sidebar links, edit localhost/wiki/MediaWiki:Sidebar
links follow the page|text format.  example:
http://www.funtoo.org/MediaWiki:Sidebar
=== Rss subscriptions ===
Rss is handy to track page changes.  all individual pages can be tracked for changes under mediawiki.  For example, if you wish to track your user talk pages via rss, go to your talk page, navigate to history.  add &feed=rss to the end.  &feed=atom is also valid.
http://www.funtoo.org/index.php?title=User:Drobbins&action=history&feed=rss
=== ArticlePath ===
By default, MediaWiki pages will have a URL of <code>wiki.myserver.com/index.php?title=PageName</code>. With a few minor tweaks, you can tell MediaWiki to use <code>wiki.myserver.com/PageName</code> instead. Here's how. Open up <code>LocalSettings.php</code> and search for the <code>$wgScriptPath</code> line. This part of the config will look like this:
<pre>
$wgScriptPath      = "";
$wgScriptExtension  = ".php";
</pre>
Change this part of the file to look like this:
<pre>
$wgScriptPath      = "";
$wgArticlePath      = "/$1";
$wgUsePathInfo      = true;
$wgScriptExtension  = ".php";
</pre>
The old-style URLs will still work, but the shorter more intuitive URLs will now be used for all wiki links.
=== $wgSpamRegex ===
You may find that your wiki is the target of spammers. The easiest way to combat spam is to set <code>$wgSpamRegex</code> in <code>LocalSettings.php</code>, like so:
<pre>
$wgSpamRegex = "/badword1|badword2|badword3/i"
</pre>
This will perform a case-insensitive match against the bad words and block anyone from saving edits that contain these words.
=== DNS Blacklist ===
MediaWiki also has the ability to consult a DNS blacklist to prevent known forum and wiki spam sites from performing any edits on your wiki. To enable this capability, add the following to <code>LocalSettings.php</code>:
<pre>
$wgEnableDnsBlacklist = true;
$wgDnsBlacklistUrls = array( 'xbl.spamhaus.org', 'opm.tornevall.org' );
</pre>
You may notice a significant decrease in spam posts.
=== $wgExternalLinkTarget ===
For external links if you wish for the link to open a new tab or new window for the external link add this to your LocalSettings.php
{{file|name=/var/www/localhost/htdocs/mediawiki/LocalSettings.php|lang=php|desc=set external links to open in a new tab|body=
...
$wgExternalLinkTarget = '_blank';
}}
=== $wgRawHtml ===
{{warning|raw html can be dangerous regarding injecting spam/malicious/fishing pages.  use with care!}}
To allow any raw html inserted into your wiki:
{{file|name=/var/www/localhost/htdocs/mediawiki/LocalSettings.php|lang=php|desc=enabling arbitrary html|body=
...
$wgRawHtml = "true";
}}
=== $wgServer ===
Here is an important tip -- the <code>$wgServer</code> variable in <code>LocalSettings.php</code> defines the URL of your MediaWiki installation. MediaWiki will encode this within its HTML replies, which means that the Web browser from which you are accessing MediaWiki must be able to reach your server using this address, or pages will not display. This is not a security feature in any way, but a configuration issue. For example, if <code>$wgServer</code> is set to <code>10.0.1.128</code>, then the only systems that will be able to access your MediaWiki installation are those for which <code>10.0.1.128</code> resolves to your MediaWiki installation.  The same is true of non-IP <code>$wgServer</code> entries like <code>wiki.mysite.com</code>. If you are setting up a test wiki, you may need a temporary entry in a desktop's <code>/etc/hosts</code> file so that it can interact with the wiki properly before DNS is set up.
=== $wgLogo ===
If you want to change the wiki logo, edit <code>LocalSettings.php</code> and replace $wgLogo with the location of the image you want to use:
<pre>
$wgLogo = "image.png"
</pre>
{{fancynote| The above references the file <code>image.png</code> in the directory <code>/home/docs/public_html</code>}}
=== MySQL wildcard searches ===
Recent versions of mediawiki have broken search results.
{{file|name=/var/www/localhost/htdocs/mediawiki/includes/search/SearchMySQL.php|lang=php|desc=line 175 modification to repair mysql searches|body=
if ( trim( $term ) === '' ) {
return null;
} else {
$term = $term . '*';
}
}}
=== License Badges ===
You can have licenses displayed with your pages.
{{file|name=/var/www/localhost/htdocs/mediawiki/LocalSettings.php|lang=php|desc=add license badge to articles|body=
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
$wgRightsUrl = "http://creativecommons.org/licenses/by-sa/3.0/"; //external source explaining license
$wgRightsText = "Creative Commons Attribution Share Alike"; //alternate text on the image
$wgRightsIcon = "{$wgStylePath}/common/images/cc-by-sa.png";
}}
There are 6 possible badge images
* {$wgStylePath}/common/images/cc-0.png
* {$wgStylePath}/common/images/cc-by-nc-sa.png
* {$wgStylePath}/common/images/cc-by-sa.png
* {$wgStylePath}/common/images/cc-by.png
* {$wgStylePath}/common/images/gnu-fdl.png
* {$wgStylePath}/common/images/public-domain.png
=== Importing Google Fonts & External Css ===
Googles font api is excellent.  all you have to do is look through https://www.google.com/fonts# and select which font you want.  To the bottom right of the font pane is a little box with an arrow pointing right.  click the arrow, and follow step 1, and 2.  for step 3 you need to select @import.  on your wiki navigate to localhost/MediaWiki:Common.css or a specific skin to add the css to like localhost/MediaWiki:Vector.css and enter this code.
{{file|name=localhost/MediaWiki:Common.css|lang=css|desc=|body=
@import url(http://fonts.googleapis.com/css?family=Lobster);
.firstHeading, #mw-head, .body ul li {
font-family: 'Lobster', cursive;
}
}}
External css is similar, if you wanted to bootswatch your wiki navigate to http://www.bootstrapcdn.com/#bootswatch_tab select which cdn and insert it into your common css.
{{file|name=localhost/MediaWiki:Common.css|lang=css|desc=yeti for the sasquatch hunter in you|body=
@import url(//maxcdn.bootstrapcdn.com/bootswatch/3.2.0/yeti/bootstrap.min.css);
}}
== Media ==
{{#widget:YouTube|playlist=PL7ABDor6eEgc2U9PH4Irty4K8mqUgkvDq}}
== Resources on this wiki ==
* [[Semantic MediaWiki]]
* [[Semantic MediaWiki Events]]
* [[ConsoleOutput MediaWiki Extension]]
== External Resources ==
* http://www.mediawiki.org/wiki/Manual:System_administration
* http://www.mediawiki.org/wiki/Manual:Performance_tuning
* http://www.mediawiki.org/wiki/Help:Templates
* http://www.mediawiki.org/wiki/Transclusion
[[Category:Featured]]
[[Category:HOWTO]]
[[Category:Official Documentation]]
[[Category:Ebuilds]]
{{EbuildFooter}}

Revision as of 10:47, May 17, 2015


Welcome to Funtoo Linux

Fwiki.png


Getting Started

Install Funtoo

Create a Funtoo account, which allows you to get involved with the community. Log in to the wiki, forums, and bug tracker under the same username, and password by unified logins. See the Auth FAQ & General FAQ.

Report bugs, and suggest improvements to our bug tracker. We take all bugs seriously, and all work performed is tracked on our public bug tracker, for purposes of transparency. See the Funtoo Linux FAQ.

Funtoo Linux is a rolling-release Linux meta-distribution for x86 and ARM systems. It uses Portage as a package manager, and is run by Daniel Robbins, creator of Gentoo Linux. It is a continuation of Daniel's work on Gentoo Linux. Funtoo Linux is committed to software freedom, independence, and a user-centric model of software development, where our users help define the future direction of the project.

Our goal is to provide a best-of-breed Gentoo-based meta-distribution that is ideal for desktop and servers, and to progressively improve our core technology in thoughtful and innovative ways, while respecting Gentoo design principles, and the history of Unix and Linux.

Funtoo Linux provides optimized builds for your specific hardware to ensure the best possible performance, and offers the following features:

  • A completely systemd-free system, including GNOME 3.14 without systemd.
  • A new profile system to simplify system configuration.
  • Improved ease of install with pre-built Debian kernel provided in our install image.
  • A new system configuration tool, ego.
  • An advanced build and quality assurance tool called Metro, providing optimized install images and enhanced real-world testing.
  • The use of git as a default mechanism for getting updated ebuilds (build scripts) to you.
  • Modular networking scripts to simplify creating sophisticated server network configurations.
  • Enhanced Python support from the Progress overlay, and inclusion of other popular packages from the Gentoo ecosystem.
   {{{title}}}
{{{body}}}

News

Ego-2.2.0 Released

User:Drobbins
2017-10-18 by
Drobbins

Latest Innovations

This news item documents the latest innovations now available under Funtoo Linux.
2017-09-07 by Drobbins
More...

Official Projects

Ebuilds

Ebuild pages recently updated: {{#ask: | order=descending | sort=Modification date | format=list | limit=10 | searchlabel= }}


{{#seo: |title=Funtoo Linux |keywords=funtoo,linux,gentoo,Daniel Robbins |description=Funtoo Linux is a Gentoo-based OS that uses a git-based Portage tree. Run by Daniel Robbins, creator of Gentoo. }}