ThinkServer - User contributions [en-gb]

OpenSUSE Leap 16.0

2026-07-10T14:13:45Z

Sam: /* Installation notes/Known Issues = */ Removed extra =

This is the Linux distribution my server is based on. More information is available [https://www.opensuse.org/ here].

If you are looking to install openSUSE, there are more details in [[obtaining openSUSE 16.0]].

== Changes to openSUSE ==
=== YaST deprication ===

YaST is no longer being developed by SuSE and therefore is not being developed for openSUSE. Therefore, YaST is not available in openSUSE 16.0. openSUSE 16.0 now uses Myrlyn for package management and Cockpit for most other things YaST used to do.

=== New installer ===

Agama is the new web based installer for openSUSE when installing via ISO image. There is also a migration tool available in previous versions that takes care of the full migration to openSUSE 16.0 automatically and painlessly.

=== Wayland compositor by default ===

openSUSE 16.0 no longer uses X and defaults to using Wayland as the desktop compositor. To use X as before, this must be installed yourself but do note, this is deprecated.

=== AppArmor no longer default ===

AppArmor is no longer the default security solution, SELinux is now the preferred security solution for openSUSE 16.0. AppArmor can, however, still be used if preferred.

== Installation notes/Known Issues ==

* If upgrading, check the "Unneeded Packages" category in Myrlyn once upgraded to remove any lingering unneeded packages from the previous version.

== Release notes ==

[[OpenSUSE Leap 16.0 Release Notes|Release Notes]]

== Information ==

openSUSE Leap 16.0 was released on 1st October 2025. It is an open-source distribution and is free of charge. It is developed by the community and sponsored by [https://www.eqtgroup.com/ EQT Partners] (formally Micro Focus and Novell).

== Previous supported versions (at time of release) ==

* openSUSE Leap 15.6 (Supported until 30th April 2026)
* openSUSE Tumbleweed (Rolling release)
<br>
[[File:openSUSE Leap 16.0 webpage.webp|center|400px]]

WireGuard

2026-07-01T16:44:37Z

Sam: Recreated lost page through Wayback Machine

WireGuard is a lightweight VPN server, built-in to the Linux kernel past kernel 5.6, making it very easy to set up on a Linux server. This guide will detail how to install on this server.

== Before you start ==
You will need to install the following packages:
* <code>openresolv</code> (for DNS resolution)
* <code>wireguard-tools</code>

=== Install the required packages ===
* Type <code>sudo zypper in openresolv wireguard-tools</code>
* Press <kbd>Y</kbd> to accept

=== Allow IP forwarding ===
WireGuard requires IP forwarding to function as it will forward packets between your network adapter and a virtual adapter.

* Open a terminal window
* Move to <code>/etc</code> - <code>cd /etc</code>
* Open <code>sysctl.conf</code> for editing - <code>sudo nano sysctl.conf</code>
* Type your root password and press <kbd>Enter</kbd>
* At the end of the file, type the following:
<pre>net.ipv4.ip_forward=1</pre>
* Press <kbd>Ctrl</kbd>+<kbd>X</kbd> then <kbd>Y</kbd> to save then <kbd>Enter</kbd> to confirm saving the file
* Load the changes - <code>sysctl -p</code>

=== Restart the computer ===
* After completing the previous steps, restart the computer. This will active <code>openresolv</code> (no further configuration needed) and ensure IP forwarding is enabled. You are now ready to configure WireGuard.

=== Allow port forwarding on the router ===
* Port 33333 or whatever port you choose later must be port forwarded through your router. Ensure this is for UDP, '''NOT''' TCP.

== Configure the server ==
We will now configure the server settings for WireGuard. WireGuard comes complete with tools to create the the private/public keys needed to function and is configured with a simple configuration file.

=== Become a superuser ===
For the following sets, you may need to become a superuser (<code>su</code>) to access the WireGuard folder.

* Become a superuser - <code>su</code>

=== Move to WireGuard directory ===
* Type your root password and press <kbd>Enter</kbd>. The terminal text should change to red to indicate you are now a superuser.
* Move to the WireGuard directory - <code>cd /etc/wireguard</code>

You will find this directory is empty - we will work in this directory which is secure.

=== Generate a public/private key pair ===
* Generate a private and public key for the server. You can use the following command:
<pre>wg genkey | tee server-privatekey | wg pubkey > server-publickey</pre>
* <code>server-privatekey</code> and <code>server-publickey</code> are filenames and can be anything you want and can be changed accordingly. These files are not directly used by WireGuard.

<div style="background:#FFEEEE;border:1px solid #FF0000;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Warning'''

The private key generated should '''NEVER''' leave the server. Anyone with the private key can connect to and compromise the server. If the key does become compromised, a new private key should be generated and configured immediately and the old key never used again.

To keep private keys secure once used, it is advisable to store the private key somewhere offline and secure, away from the server. One example would be a USB stick. This way, if the server is compromised, it will be more difficult to compromise the private key. Ensure the permissions are correct as follows so that access is restricted to only superusers.

The public key is safe from compromise, this does not need to be stored with such security.

All private/public keys in this guide were generated as an example and are not in use on this server.
</div>

* Change the permissions of the private key so that only superusers can access the key: <code>chmod 600 server-privatekey</code>
* We need the private key to put in the configuration file: <code>cat server-privatekey</code>. This will display the key on the screen which can then be copied.

=== Create configuration file ===
* We will create a configuration file with the same name as the interface WireGuard will create: <code>nano wg0.conf</code>
* Insert the following into the file:
<pre>
[Interface]
## Local Address : A private IP address for wg0 interface.
Address = 10.20.10.1/24
ListenPort = 33333

## local server privatekey
PrivateKey = iFFxF+gX39U9O4L4qt2mufTS441YWLu5WVt0mMPpLEA=

## The PostUp will run when the WireGuard Server starts the virtual VPN tunnel.
## The PostDown rules run when the WireGuard Server stops the virtual VPN tunnel.
## Specify the command that allows traffic to leave the server and give the VPN clients access to the Internet.
PostUp = iptables -A FORWARD -i wg0 -j ACCEPT
PostUp = iptables -t nat -A POSTROUTING -o em1 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT
PostDown = iptables -t nat -D POSTROUTING -o em1 -j MASQUERADE
</pre>
* Tweak the file to match your server configuration:
** <code>Address = 10.20.10.1/24</code> - this is the address used by the WireGuard interface and should be different from your local network subnet.
** <code>ListenPort = 33333</code> - 33333 is the default WireGuard network port but can be changed to anything you like as long as the port is not already in use by something else.
** <code>PrivateKey = iFFxF+gX39U9O4L4qt2mufTS441YWLu5WVt0mMPpLEA=</code> - Paste the key your generated and copied earlier.
** <code>PostUp = iptables -t nat -A POSTROUTING -o em1 -j MASQUERADE</code> and <code>PostDown = iptables -t nat -D POSTROUTING -o em1 -j MASQUERADE</code> - the interface needs changing according to the name of the Ethernet card on your computer (<code>em1</code> in this example, which can be found by typing <code>ip a</code>. Common names include <code>eth0</code>, <code>eno1</code> and <code>em1</code>.
* Once done, save the file: <kbd>Ctrl</kbd>+<kbd>X</kbd>, <kbd>Y</kbd> then <kbd>Enter</kbd>.
* Change the permissions so that the configuration file can only be accessed by superusers: <code>chmod 600 wg0.conf</code>

== Start WireGuard ==
* Type <code>systemctl start wg-quick@wg0</code> to start WireGuard.
** <code>wg0</code> is the name of the WireGuard interface and configuration file we created. If different, this should be changed to match the same name as the configuration file.
* Check that WireGuard is running: <code>wg show</code>. You should see something similar to the following if all is well:
<pre>
interface: wg0
public key: 7IXE2Ej++JNHXDeP9mt9/N+OslIBmvOAREzCnT0v6To=
private key: (hidden)
listening port: 33333
</pre>
* The public key should match the one generated earlier and can be viewed by typing <code>cat server-publickey</code>
* If you would like WireGuard to start on startup, type the following: <code>systemctl enable wg-quick@wg0</code>

== Setting up a client ==
Client software is available for many operating systems, including Windows, macOS, Linux (native support past Kernel 5.6) and Android. Here we will make a config file and add it to the server configuration, but due to the vast amount of different operating systems supported, we will not cover how to add the configuration to your respective operating system.

The client configuration file is similar to the server configuration file and remains very simple.

=== Generate a public/private key pair ===
* We will generated a public/private key pair much the same way as we did for the server:
<pre>wg genkey | tee client-privatekey | wg pubkey > client-publickey</pre>
** The name <code>client</code> for the file name can be changed to anything you like for convenience.
* Change the permissions of the private key so that only superusers can access the key: <code>chmod 600 client-privatekey</code>
* We need the private key to put in the configuration file: <code>cat client-privatekey</code>. This will display the key on the screen which can then be copied.

=== Creating a configuration file ===
* Open a new configuration file: <code>sudo nano client.conf</code>
** Once again, the name <code>client</code> can be anything you like for convenience.
* Insert the following into the file:
<pre>
[Interface]
PrivateKey = 4JYkCM3VBuRpJAHjj8S8LyunF+Can5ZLCxB8OjXo9WI=
ListenPort = 33333
Address = 10.20.10.2/24
DNS = 1.1.1.1, 1.0.0.1

[Peer]
PublicKey = 7IXE2Ej++JNHXDeP9mt9/N+OslIBmvOAREzCnT0v6To=
AllowedIPs = 0.0.0.0/0
Endpoint = example.com:33333
</pre>
* Tweak the file to match your client configuration:
** <code>PrivateKey = 4JYkCM3VBuRpJAHjj8S8LyunF+Can5ZLCxB8OjXo9WI=</code> - the private key generated for the client ('''NOT''' the server private key).
** <code>ListenPort = 33333</code> - needs to match the <code>ListenPort</code> for the server.
** <code>Address = 10.20.10.2/24</code> - the address to use, within the subnet defined in the server configuration.
** <code>DNS = 1.1.1.1, 1.0.0.1</code> - the DNS server to use to resolve names. Something needs to be defined here as there is no DHCP to define a DNS server. This can be a server of your own on the network, your router or one of the many online services (CloudFlare DNS = 1.1.1.1, 1.0.0.1, Google DNS = 8.8.8.8, 8.8.4.4).
** <code>PublicKey = 7IXE2Ej++JNHXDeP9mt9/N+OslIBmvOAREzCnT0v6To=</code> - the public key of the server, '''NOT''' the client public key.
** <code>AllowedIPs = 0.0.0.0/0</code> - range of addresses that will be passed over the tunnel. Comma-separated list, can include IPv6 addresses if being used. 0.0.0.0/0 forwards everything.
** <code>Endpoint = example.com:33333</code> - DNS address or IP address to connect to the server. An IP address will only be useful if you have a static address, otherwise a DNS address with DynDNS is a better solution.
* Save the file - <kbd>Ctrl</kbd>+<kbd>X</kbd>, <kbd>Y</kbd> then <kbd>Enter</kbd>.
* The file can then be transferred to the client and imported into the WireGuard client ready for use.

=== Adding peers to the server configuration ===
* Open the server configuration file - <code>nano wg0.conf</code>
* Add the <code>[Peer]</code> section, marked in italics, as follows:
<pre>
[Interface]
## Local Address : A private IP address for wg0 interface.
Address = 10.20.10.1/24
ListenPort = 33333

## local server privatekey
PrivateKey = iFFxF+gX39U9O4L4qt2mufTS441YWLu5WVt0mMPpLEA=

## The PostUp will run when the WireGuard Server starts the virtual VPN tunnel.
## The PostDown rules run when the WireGuard Server stops the virtual VPN tunnel.
## Specify the command that allows traffic to leave the server and give the VPN clients access to the Internet.
PostUp = iptables -A FORWARD -i wg0 -j ACCEPT
PostUp = iptables -t nat -A POSTROUTING -o em1 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT
PostDown = iptables -t nat -D POSTROUTING -o em1 -j MASQUERADE

''[Peer]''
''# one client which will be setup to use 10.20.10.2 IP''
''PublicKey = 92p5r33HRrEvzlQJIdANcyIKx0JgtNV5VfQOOwLnFwM=''
''AllowedIPs = 10.20.10.2/32''
</pre>
* Tweak the file to match your client configuration:
** <code>PublicKey = 92p5r33HRrEvzlQJIdANcyIKx0JgtNV5VfQOOwLnFwM=</code> - the public key generated for the client.
** <code>AllowedIPs = 10.20.10.2/32</code> - the IP address used for the tunnel, should match the client configuration file.
* Save the file - <kbd>Ctrl</kbd>+<kbd>X</kbd>, <kbd>Y</kbd> then <kbd>Enter</kbd>.

== Reloading the server ==
For our changes to take effect, the WireGuard daemon needs to be reloaded or restarted using:
<pre>systemctl reload wg-quick@wg0</pre>
or
<pre>systemctl restart wg-quick@wg0</pre>

At this point, the WireGuard VPN is ready to go!

== Adding further clients ==
* Generate a public/private key pair as explained under the client section.
* Create a configuration with the new public/private key pair generated.
* Copy the configuration to the respective client.
* Add another <code>[Peer]</code> section to the server configuration.
* Reload the WireGuard server.

== See also ==
Thank you to "Mark Liversedge" at [https://markliversedge.blogspot.com/2023/09/wireguard-setup-for-dummies.html Wireguard setup for dummeies] with his comprehensive guide that made this possible for me

OpenSUSE Leap 16.0 Release Notes

2026-07-01T16:40:22Z

Sam: Recreated lost page through Wayback Machine

'''Publication Date:''' 2025-09-29

openSUSE Leap is a modern, modular operating system suitable for both traditional IT and multimodal workloads. This document highlights major features, updates, and known limitations.

== About the release notes ==
These Release Notes are identical across all architectures, and the most recent version is always available online at https://doc.opensuse.org.

Entries are only listed once but they can be referenced in several places if they are important and belong to more than one section.

Release notes usually only list changes that happened between two subsequent releases. Certain important entries from the release notes of previous product versions are repeated. To make these entries easier to identify, they contain a note to that effect.

However, repeated entries are provided as a courtesy only. Therefore, if you are skipping one or more service packs, check the release notes of the skipped service packs as well. If you are only reading the release notes of the current release, you could miss important changes.

=== Documentation and other information ===
For the most up-to-date version of the documentation for openSUSE Leap, see:
* https://doc.opensuse.org.

This section describes community-driven enhancements, features, and updates that extend the SUSE Linux Enterprise core. These changes reflect the openSUSE project's unique contributions, including desktop improvements, additional packages, and new workflows.

== openSUSE Leap Community Additions ==

=== Lifecycle ===
Each openSUSE Leap minor release is published once every 12 months. openSUSE Leap 16 provides maintenance updates over two minor releases, giving each release a full 24 months of community support.

Unless there is a change in release strategy, the final openSUSE Leap version (16.6) will be released in fall 2031 and will continue receiving updates until the release of openSUSE Leap 17.1 two years later.

For more information, see: [https://en.opensuse.org/Roadmap Roadmap].

For more than 24 months of support for a point release, the openSUSE migration tool makes it simple to move to SUSE Linux Enterprise, which provides decades of support. See [https://www.suse.com/support/policy.html Support Policy] and [https://www.suse.com/support/programs/long-term-service-pack-support.html Long Term Service Pack Support].

=== Migration from Leap 15.6 ===
The [https://github.com/openSUSE/opensuse-migration-tool openSUSE migration tool] (<code>zypper in opensuse-migration-tool</code>) is included as part of openSUSE Leap 15.6. Users migrating from older releases can run the tool from [https://github.com/openSUSE/opensuse-migration-tool Git repository].

For more information, refer to: [https://en.opensuse.org/SDB:System_upgrade SDB:System_upgrade].

=== Installer and Desktop Environments ===
* openSUSE Leap 16 installer provides only Wayland variants of desktop environments. Xorg-based environments can be installed manually post-installation.

==== NVIDIA and Graphics Issues with the Installation Image ====
Some users with NVIDIA GPUs may experience graphics-related issues during installation, such as boo#1247670 where X server fails to start. This is due to the fact that openSUSE Leap install image contains <code>kernel-default-optional</code> and <code>kernel-default-extra</code>

If you encounter problems specific to the <code>nouveau</code> driver, try booting with the option: <code>rd.driver.blacklist=nouveau</code>

For general graphics boot problems, use the option: <code>nomodeset</code>

==== Experimental Xfce Wayland session ====
Experimental Xfce Wayland session is available as an installation option. openSUSE Leap is one of the first distributions to provide Wayland support for [https://en.opensuse.org/Portal:Xfce Xfce]. We use <code>gtkgreet</code> with <code>greetd</code> as a Wayland-ready replacement for LightDM (used in the X11 variant).

==== LXQt Wayland session available post install ====
LXQt Wayland session is included, but will become a full installer option in later releases once LXQt Miriway efforts are further developed: https://code.opensuse.org/leap/features/issue/192.

=== Changes to the openSUSE Welcome ===
openSUSE Leap 16 now uses the <code>opensuse-welcome-launcher</code> to start the appropriate greeter application. This launcher, in combination with <code>gnome-tour</code> and <code>plasma-welcome</code>, replaces the legacy Qt5-based <code>opensuse-welcome</code>, which was previously the default greeter.

The launcher also allows the openSUSE release team to update or refresh the displayed greeter via a package update, for example after a major GNOME update. To create a custom appliance without a welcome application, or to deploy a system where the greeter should never appear, remove <code>opensuse-welcome-launcher</code>.

=== Automated NVIDIA Driver and Repository Setup ===
On supported GPUs, NVIDIA's open driver is installed by default along with the NVIDIA graphics driver repository. In openSUSE Leap 16, user-space drivers are also automatically installed, enabling graphical acceleration out of the box.

=== Security ===
==== AppArmor ====
AppArmor has been updated from version 3.1 to 4.1.
* Version [https://gitlab.com/apparmor/apparmor/-/wikis/Release_Notes_4.0.1 4.0] introduced fine-grained network rules (limitable by IP/port), but kernel support is not upstream yet.
* Version [https://gitlab.com/apparmor/apparmor/-/wikis/Release_Notes_4.1.0 4.1] introduced the <code>priority=<number></code> rule prefix, which allows overriding rules.

==== AppArmor not available by default on new installations ====
<div style="background:#FFEEEE;border:1px solid #FF0000;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Warning'''

AppArmor is no longer available in SUSE Linux Enterprise 16.0. Leap users cannot select AppArmor as the Linux Security Module (LSM) during a new installation. AppArmor can still be enabled post-installation. For instructions, refer to AppArmor wiki page.
</div>

Users migrating manually from 15.6 will retain AppArmor by default. Users migrating with [https://github.com/openSUSE/opensuse-migration-tool openSUSE migration tool] will be prompted to either switch to SELinux or preserve AppArmor during post-migration.

=== Steam ===
<div style="background:#FFEEEE;border:1px solid #FF0000;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Warning'''

The <code>Steam</code> package has been removed from the [https://en.opensuse.org/Package_repositories#Non-OSS Non-OSS repository] due to limited 32-bit library support. Users are advised to install it via [https://en.opensuse.org/Steam#Flatpak Flatpak].
</div>

* 32-bit execution requires installing <code>grub2-compat-ia32</code> and rebooting.
* SELinux users may also need <code>selinux-policy-targeted-gaming</code>. For details, refer to [https://en.opensuse.org/Portal:SELinux/Common_issues#Steam_Proton,_Bottles,_WINE,_Lutris,_not_working SELinux wiki page].

=== Wine ===
openSUSE Leap includes wine 10.10, available only in the [https://gitlab.winehq.org/wine/wine/-/wikis/Building-Wine#shared-wow64 wow64] flavor. Users requiring 32-bit binary execution should consider using the Flatpak version or a similar solution.

=== Networking ===
==== Broken libvirt networking when using Docker ====
<div style="background:#FFEEEE;border:1px solid #FF0000;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Warning'''

If networking inside libvirt-managed virtual machines fails while Docker is running, it is likely due to Docker not supporting <code>nftables</code>.
</div>

To fix the issue:
* Edit <code>/etc/libvirt/network.conf</code> and set:
<pre>firewall_backend = "iptables"</pre>
* Add the virtual network interface to the libvirt firewall zone:
<pre>firewall-cmd --add-interface=virbr0 --zone=libvirt --permanent
firewall-cmd --reload</pre>
* Restart libvirt and related services:
<pre>systemctl restart libvirtd</pre>
This restores networking for libvirt VMs while Docker is active.

=== GNU Health ===
[https://www.gnuhealth.org/ GNU Health] has been updated to major release 5.0.2. The underlying ERP framework, Tryton, has been updated to LTS version 7.0. Functional improvements include enhanced medical image workflows and better integration with Orthanc 1.12.9 (PACS server).

=== PipeWire replaces PulseAudio ===
openSUSE Leap 16.0 uses PipeWire by default. Users upgrading from previous releases should be automatically migrated from PulseAudio. <code>opensuse-migration-tool</code> provides a post-migration script if migration does not occur automatically.

If experiencing audio issues, ensure you are not using the <code>wireplumber-video-only-profile</code>. For details, refer to [https://en.opensuse.org/openSUSE:Pipewire#Installation PipeWire#Installation] for details.

=== Hexchat drop ===
Hexchat IRC client has been dropped as the [https://github.com/hexchat/hexchat upstream project] is archived. Alternatives include [https://software.opensuse.org/package/polari Polari] or the Flatpak version: [https://flathub.org/en/apps/io.github.Hexchat Flatpak].

=== Configuring boot entry with serial console ===
See https://en.opensuse.org/SDB:SerialConsole for guidance.

This section describes the enterprise-grade foundation of openSUSE Leap, based on SUSE Linux Enterprise. Content here is adapted from the SUSE Linux Enterprise release notes to reflect core functionality, security updates, and enterprise features that openSUSE Leap inherits.

== SUSE Linux Enterprise Core ==

=== What's new? ===
==== Package and module changes in 16.0 ====
The full list of changed packages compared to 15 SP7 can be seen at this URL:

https://documentation.suse.com/package-lists/sle/16.0/package-changes_SLE-15-SP7-GA_SLE-16.0-GA.txt

The full list of changed modules compared to 15 SP7 can be seen at this URL:

https://documentation.suse.com/package-lists/sle/16.0/module-changes_SLE-15-SP7-GA_SLE-16.0-GA.txt

=== Support and lifecycle ===
openSUSE Leap is backed by award-winning support from SUSE, an established technology leader with a proven history of delivering enterprise-quality support services.

The current version (16.0) will be fully maintained and supported until 31 Jul 2034.

If you need additional time to design, validate and test your upgrade plans, Long Term Service Pack Support can extend the support duration. You can buy an additional 12 to 36 months in twelve month increments. This means that you can receive support up to Dec 2037.

For more information, see the pages [https://www.suse.com/support/policy.html Support Policy] and [https://www.suse.com/support/programs/long-term-service-pack-support.html Long Term Service Pack Support].

=== Support statement for openSUSE Leap ===
To receive support, you need an appropriate subscription with SUSE. For more information, see https://forums.opensuse.org.

The following definitions apply:

; L1
: Problem determination, which means technical support designed to provide compatibility information, usage support, ongoing maintenance, information gathering, and basic troubleshooting using the documentation.
; L2
: Problem isolation, which means technical support designed to analyze data, reproduce customer problems, isolate the problem area, and provide a resolution for problems not resolved by Level 1 or prepare for Level 3.
; L3
: Problem resolution, which means technical support designed to resolve problems by engaging engineering to resolve product defects which have been identified by Level 2 Support.

For contracted customers and partners, openSUSE Leap is delivered with L3 support for all packages, except for the following:
* Technology Previews, see Section "Technology previews"
* Sound, graphics, fonts and artwork
* Packages that require an additional customer contract, see Section "Software requiring specific contracts"
* Some packages shipped as part of the module ''Workstation Extension'' are L2-supported only
* Packages with names ending in <code>-devel</code> (containing header files and similar developer resources) will only be supported together with their main packages.

SUSE will only support the usage of original packages. That is, packages that are unchanged and not recompiled.

==== General support ====
To learn about supported features and limitations, refer to the following sections in this document:
* Section "Virtualization"
* Section "Removed and deprecated features and packages"

==== Software requiring specific contracts ====
Certain software delivered as part of openSUSE Leap may require an external contract. Check the support status of individual packages using the RPM metadata that can be viewed with <code>rpm</code>, <code>zypper</code>, or <code>YaST</code>.

Major packages and groups of packages affected by this are:
* PostgreSQL (all versions, including all subpackages)

==== Software under GNU AGPL ====
openSUSE Leap 16.0 (and the SUSE Linux Enterprise modules) includes the following software that is shipped ''only'' under a GNU AGPL software license:
* Ghostscript (including subpackages)
* <code>velociraptor</code> and <code>velociraptor-client</code>
* <code>zypp-boot-plugin</code>

openSUSE Leap 16.0 (and the SUSE Linux Enterprise modules) includes the following software that is shipped under multiple licenses that include a GNU AGPL software license:
* MySpell dictionaries and LightProof
* ArgyllCMS

=== Technology previews ===
Technology previews are packages, stacks, or features delivered by SUSE to provide glimpses into upcoming innovations. Technology previews are included for your convenience to give you a chance to test new technologies within your environment. We would appreciate your feedback! If you test a technology preview, contact your SUSE representative and let them know about your experience and use cases. Your input is helpful for future development.

Technology previews come with the following limitations:
* Technology previews are still in development. Therefore, they may be functionally incomplete, unstable, or in other ways not suitable for production use.
* Technology previews are not supported.
* Technology previews may only be available for specific hardware architectures. Details and functionality of technology previews are subject to change. As a result, upgrading to subsequent releases of a technology preview may be impossible and require a fresh installation.
* Technology previews can be removed from a product at any time. This may be the case, for example, if SUSE discovers that a preview does not meet the customer or market needs, or does not comply with enterprise standards.

=== <code>lklfuse</code> ===
As technology preview, <code>lklfuse</code> is available in openSUSE Leap 16.0.

<code>lklfuse</code> is intentionally built without Btrfs support. Btrfs filesystems can be multi-device (for example, RAID1) but <code>lklfuse</code> currently only supports a single device per mount.

=== Changes affecting all architectures ===
* <code>rasdaemon</code> has been updated to version 8.3.0. This version supports machine checks related to CXL memory.
* We now provide Grafana Alloy which can integrate with SUSE Observability as well.
* <code>NetworkManager</code> is now the only network configuration stack in openSUSE Leap 16.0.
* We now provide a unified image that can be used to install either SLES or SLES for SAP

==== Userspace live patching ====
Currently, <code>libpulp</code> supports ULP (user space live patching) of <code>glibc</code> and <code>openssl</code> binaries on the following architectures:
* x86-64
* ppc64le

For more information see https://documentation.suse.com/sles/15-SP7/html/SLES-all/cha-ulp.html

==== Switch to <code>mountfd</code> API in <code>util-linux</code> ====
The <code>util-linux</code> mount command has switched from the old string-based method to the new kernel <code>mountfd</code> API. This change introduces new features but also comes with some minor incompatibilities.

There is a special case that cannot be handled by <code>mountfd</code> and needs to be handled by applications:
* <code>mountfd</code> discriminates between the physical mount layer and the virtual mount layer
* once the physical mount layer is read-only, read-write mount on the virtual layer is not possible

If the first mount is read-only, then the physical filesystem is mounted read-only, and later mounting of the same file system as read-write is not possible. To solve this problem, the first mount needs to be read-only on the virtual layer only, keeping the physical layer read-write. The userspace fix is simple. Instead of:
<pre>mount -oro</pre>
use
<pre>mount -oro=vfs</pre>
This will keep the physical layer read-write, but the virtual file system layer (and the userspace access) read-only.

==== Switch to predictable network names ====
The persistent network naming scheme used in Leap 15 became legacy with the switch to the systemd predictable network names. For complicated setups, we recommend using <code>systemd.link</code>.

For more information, see:
* https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/
* https://www.freedesktop.org/software/systemd/man/latest/systemd.link.html

<div style="background:#C0C0C0;border:1px solid #666666;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Note'''

In the future, when upgrading from SL Micro to Leap 16.1 (so-called "SLE merge"), some systems will have <code>net.ifnames=0</code> set on their kernel command line (this is the case for new installations of SL Micro 6.0 and 6.1). This boot option will prevent the system from switching to the predictable naming scheme and it will need to be removed.
</div>

==== systemd default configurations moved to <code>/usr</code> ====
Main configuration files have been moved from <code>/etc</code> to <code>/usr</code>. This ensures that main configuration files have lower precedence, allowing them to be overriden by package-supplied drop-in snippets.

Local configuration should be created by either modifying the default file in <code>/usr</code> (or a copy of it placed in <code>/etc</code> if the original file is shipped in <code>/usr</code>), or by creating drop-in snippets in the appropriate directory in (for example, <code>/etc/systemd/coredump.conf.d/</code>) - this is recommended.

Remove configurations in <code>/etc</code> to restore defaults.

==== Password access as root via SSH disabled ====
Previously, it was possible to SSH as root using password-based authentication. In Leap 16.0 only key-based authentication is allowed by default. Systems upgraded to 16.0 from a previous version will carry over the old behavior. New installations will enforce the new behavior.

Installing the package <code>openssh-server-config-rootlogin</code> restores the old behavior and allows password-based login for the root user.

==== Minimum hardware requirements ====
openSUSE Leap 16.0 requires hardware to meet requirements on these architectures:
* For AMD64 and Intel* 64 systems: Microarchitecture level x86-64-v2 or higher.
* For IBM* Power LE systems: POWER10 or higher (see note below).
* For Arm64* systems: Armv8.0-A or higher.
* For IBM* Z systems: z14 or higher.

<div style="background:#C0C0C0;border:1px solid #666666;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Note'''

POWER9 systems may work with Leap 16.0 but are not supported by IBM, the hardware vendor.
</div>

==== SHA1 to be disabled or mark unapproved ====
Due to FIPS 140-3 certification requirements, the SHA1 cryptographic algorithm will be disabled or marked unapproved when running in FIPS mode.

==== Added <code>tuned</code> ====
The <code>tuned</code> package contains a daemon that tunes system settings dynamically.

==== Lightweight guard region support ====
This is a new feature in <code>madvise()</code> that installs a lightweight guard region into a specified address range.

See [https://manpages.opensuse.org/Leap-16.0/man-pages/madvise.2.en.html#MADV_GUARD_INSTALL madvise() man page] for more information.

==== Harmless error messages sometimes displayed when launching some applications ====
The following messages are sometimes displayed when launching specific applications:

# <code>gnome-desktop</code> some times failes to create transient scope:
<pre>> gnome-session-binary: GnomeDesktop-WARNING: Could not create transient scope for PID 7883: GDBus.Error:org.freedesktop.DBus.Error.UnixProcessIdUnknown: Process with ID 7883 does not exist.</pre>
# <code>systemd</code> sometimes fails to assign cgroup:
<pre>> systemd: app-gnome-gnome\x2dkeyring\x2dpkcs11-6708.scope: Couldn't move process 6708 to requested cgroup '/user.slice/user-0.slice/user@0.service/app.slice/app-gnome-gnome\x2dkeyring\x2dpkcs11-6708.scope': No such process
> systemd: app-gnome-gnome\x2dkeyring\x2dpkcs11-6708.scope: Failed to add PIDs to scope's control group: No such process
> systemd: app-gnome-gnome\x2dkeyring\x2dpkcs11-6708.scope: Failed with result 'resources'.
> systemd: Failed to start Application launched by gnome-session-binary.</pre>

These messages are harmless and can be ignored.

==== NFS over TLS support ====
NFS over TLS is now supported for storage traffic.

==== <code>saptune</code> replaces <code>sapconf</code> ====
In Leap 16.0, <code>sapconf</code> is replaced with <code>saptune</code>. <code>saptune</code> will also be enabled with a base tuning, similar to <code>sapconf</code>. Base tuning only will be enabled if <code>saptune</code> was not configured before (no SAP Notes or Solutions selected).

==== Azure Entra ID authentication via <code>himmelblau</code> ====
The <code>himmelblau</code> package has been added. It provides interoperability with Microsoft Azure Entra ID and Intune. It supports Linux authentication to Microsoft Azure Entra ID via PAM and NSS modules.

For more information see https://github.com/himmelblau-idm/himmelblau.

==== Legacy BIOS support ====
Legacy BIOS is still supported in openSUSE Leap 16.0. However, some features are not available when using it (for example, full-disk encryption with TPM). Finally, support for legacy BIOS will be discontinued in the future. For that reason we recommend switching to UEFI at the nearest opportunity.

==== <code>/tmp</code> not persistent ====
In openSUSE Leap 16.0, <code>/tmp</code> is no longer persistent between reboots but uses <code>tmpfs</code> instead. See https://susedoc.github.io/doc-modular/main/html/SLE-comparison/index.html#sle16-tmp for more information.

==== Python update strategy ====
* <code>/usr/bin/python3</code> is currently set to use Python 3.13. In a future minor version update this is likely going to be changed to a newer Python version.
* openSUSE Leap 16.0 contains around 700 popular Python packages, which form a basic set of functionality for packages that depends on Python and for developing apps without needing to install Python modules from an external provider.
* We have been working on removing the dependencies of packages and tools on the <code>/usr/bin/python3</code> binary, which means that openSUSE Leap could use a newer version of the Python interpreter in the future. This new Python interpreter will coexist with the previous version that will then be maintained as legacy interpreter for a limited time.

==== Removal of 32-bit support ====
openSUSE Leap 16.0 only supports 64-bit binaries. Support for 32-bit binaries (or 31-bit binaries on IBM Z) has been removed.

This means that statically-linked 32-bit binaries (or 31-bit binaries on IBM Z) and container images cannot be run anymore. 32-bit syscalls are still enabled by default on arm64, and can be enabled on x86_64 via the kernel parameter <code>ia32_emulation</code>. On other architectures it's disabled without any option to enable it.

==== Compiling kernel uses non-default compiler ====
Customers who need to build kernel modules or rebuild the kernel must use the same compiler version the kernel was built with. The kernel is built with <code>gcc</code> version 13, which is not the default compiler. Install the <code>gcc</code> version 13 compiler using the gcc13 package and invoke it with the command <code>gcc-13</code>. This specific compiler version is only supported for building kernel modules and the kernel.

==== Optimized libraries for newer hardware architectures ====
We have added support for the glibc-HWCAPS feature which loads optimized versions of libraries for specific newer CPUs automatically.

The build infrastructure for this feature is enabled for the following libraries:
* <code>blosc2</code>
* <code>boost</code>
* <code>brotli</code>
* <code>bzip2</code>
* <code>flac</code>
* <code>jsoncpp</code>
* <code>lame</code>
* <code>leveldb</code>
* <code>libdb-4_8</code>
* <code>libgcrypt</code>
* <code>libiscsi</code>
* <code>libjpeg-turbo</code>
* <code>libjxl</code>
* <code>libmng</code>
* <code>libnettle</code>
* <code>libpng16</code>
* <code>libvorbis</code>
* <code>libxmlb</code>
* <code>lz4</code>
* <code>lzo</code>
* <code>openjpeg2</code>
* <code>openssl-3</code>
* <code>python311</code>
* <code>python313</code>
* <code>sqlite3</code>
* <code>talloc</code>
* <code>tree-sitter</code>
* <code>wavpack</code>
* <code>xxhash</code>
* <code>xz</code>
* <code>zlib</code>
* <code>zopfli</code>
* <code>zstd</code>

==== No remote root login with password ====
<div style="background:#FFEEEE;border:1px solid #FF0000;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Warning'''

If you install the system using only a <code>root</code> password and do not provide an SSH key for the root user, <code>sshd</code> will not be enabled automatically after installation. You will not be able to log in remotely as root using the password.
</div>

By default, remote password-based <code>root</code> login is disabled. The installer enables the <code>sshd</code> service only when an SSH key for root is configured during setup. To allow remote <code>root</code> login, configure an SSH key for root during installation.

==== Default user group assignment changed ====
Previously, all user accounts belonged to a single <code>users</code> group.

Now instead of being added to the common <code>users</code> group, each new user now gets their own primary group matching their username. This is due to <code>USERGROUPS_ENAB</code> being enabled in <code>/usr/etc/login.defs</code>. This change affects all new installations and upgraded systems that did not change the default <code>/etc/login.defs</code>. This has several consequences:
* files created by new users are not group-readable by default
* configurations that used the primary <code>users</code> group as a condition do not work anymore
* configurations that used the primary or secondary <code>users</code> group as a condition need to have the <code>users</code> group manually added to these user accounts in order to continue to work, for example, to for <code>@users</code> in the sudoers file
* home directories inherited from a previous system need to standardize the GID of the files by running:
: <code>find "$HOME" -group users -exec chgrp myuser {} \;</code> or <code>chgrp -R myuser "$HOME"</code> if you did not use any GID other than <code>users</code>

==== SysV init.d scripts support ====
SysV init.d scripts have been [https://www.suse.com/releasenotes/x86_64/SUSE-SLES/15-SP2/index.html#jsc-SLE-7690 deprecated since Leap 15 SP2].

In Leap 16.0, support of SysV init.d scripts has been removed.

=== Changes affecting all architectures (RC1) ===
This section contains information specific to RC1. We are working on fixing the problems mentioned here. The content of this section will be removed for the final released product.

==== <code>/etc/services</code> removal ====
The <code>/etc/services</code> file is just a dummy file that will be removed in the future. Software that appends to it without creating it should have its behavior changed.

=== Changes affecting all architectures (Beta4) ===
This section contains information specific to Beta4. We are working on fixing the problems mentioned here. The content of this section will be removed for the final released product.

==== Configuring network interfaces during installation ====
Currently, the installer does not allow for setting up network interfaces using the UI. However, in the meantime you can use dracut-like command-line options, for example:
<pre>ifname=<interface>:<MAC>
ip=<interface>:dhcp</pre>
Additionally, the <code>inst.copy_network</code> is not available in Beta4.

==== SAP workloads on Leap 16.0 ====
For running SAP workloads on openSUSE Leap 16.0, do the following:

# Unpack the SAP installer.
# Run the following commands to change policies:
<pre>semanage boolean -m --on selinuxuser_execmod
semanage boolean -m --on unconfined_service_transition_to_unconfined_user
semanage permissive -a snapper_grub_plugin_t
restorecon -R /</pre>
# Run the following commands to lable all files:
<pre>test -d ./snapshots && restorecon -R / -e /.snapshots
test -d ./snapshots || restorecon R /</pre>
# Install SAP workload or SAP HANA
# Label all files again:
<pre>test -d /.snapshots && restorecon -R / -e /.snapshots
test -d /.snapshots || restorecon -R /</pre>

==== FIPS 140-3 not working properly ====
FIPS 140-3 installation has not been fully validated and may cause unexpected software failure or crashes. Therefore, we discourage you from using it on Beta4.

=== Changes affecting all architectures (Beta3) ===
This section contains information specific to Beta3. We are working on fixing the problems mentioned here. The content of this section will be removed for the final released product.

==== Kernel crash in QEMU ====
openSUSE Leap 16.0 requires a CPU that supports a so-called "x86-64-v2" microarchitecture. Due to this, running a Leap image using QEMU currently results in a kernel crash.

As a workaround you can run QEMU with the <code>-cpu host</code> argument.

==== Missing <code>libnsl.so.1</code> library ====
The <code>libnsl.so.1</code> library has been deprecated in SLES 15 and finally removed in openSUSE Leap 16.0.

As a workaround for applications that cannot be installed without it (but presumaly do not use it for anything), we provide the <code>libnsl-stub1</code> package that includes ABI-compatible but otherwise function-less stub of the library file.

==== <code>firewalld</code> not usable with many interfaces ====
Due to an upstream bug, <code>firewalld</code> might take a long time or time out when adding many interfaces. The error occurs when <code>firewalld</code> is restarted after applying such a configuration. The following message appears in the system logs:
<pre>ERROR:dbus.proxies:Introspect error on :1.18:/org/fedoraproject/FirewallD1: dbus.exceptions.DBusException: org.freedesktop.DBus.Error.NoReply: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.</pre>
See https://github.com/firewalld/firewalld/issues/1399 for more information.

=== Changes affecting all architectures (Beta2) ===
This section contains information specific to Beta2. We are working on fixing the problems mentioned here. The content of this section will be removed for the final released product.

==== Switch from YaST to Cockpit ====
openSUSE Leap 16.0 has switched from YaST to Cockpit for manual system administration. We have enhanced Cockpit with new modules with the intention to upstream them later. Despite being functional, bugs might appear and features might be missing.

'''New modules'''
* <code>cockpit-subscriptions</code>: register, de-register and view SUSE Linux Enterprise registrations. Does not work for unprivileged users yet.
* <code>cockpit-repositories</code>: add, remove, view repositories, change settings and refresh them. Does not work for unprivileged users yet.
* <code>cockpit-packages</code>: show installed packages, search available repositories, install and uninstall packages. Requires administrative access. Be aware that there are no safety measures implemented as far as system usability goes.

'''Enhanced modules'''
* <code>cockpit-packagekit</code>: update packages from available repositories. The module now allows to individually select packages to update.

'''Upstream modules'''

<code>cockpit</code>, <code>cockpit-bridge</code>, <code>cockpit-kdump</code>, <code>cockpit-machines</code>, <code>cockpit-networkmanager</code>, <code>cockpit-podman</code>, <code>cockpit-selinux</code>, <code>cockpit-storaged</code>, <code>cockpit-system</code>, <code>cockpit-ws</code>: these modules are updated to the recent stable base version 332 (or their respective).

'''Default selection'''

Installation of the pattern <code>cockpit</code> will pull in the following modules: <code>cockpit</code>, <code>cockpit-bridge</code>, <code>cockpit-networkmanager</code>, <code>cockpit-packagekit</code>, <code>cockpit-packages</code>, <code>cockpit-repos</code>, <code>cockpit-selinux</code>, <code>cockpit-storaged</code>, <code>cockpit-subscriptions</code>, <code>cockpit-system</code>, <code>cockpit-ws</code>.

==== <code>dovecot 2.4</code> configuration upgrade ====
In openSUSE Leap 16.0 <code>dovecot</code> has been upgraded to version 2.4. The configuration of this version is incompatible with the previous versions.

Configuration has to be updated manually. For more information see https://doc.dovecot.org/2.4.0/installation/upgrade/2.3-to-2.4.html.

=== Changes affecting all architectures (Beta1) ===
This section contains information specific to Beta1. We are working on fixing the problems mentioned here. The content of this section will be removed for the final released product.

==== Disk configuration UI during installation ====
Currently, choosing disk configurations other than "An existing disk" (installation to a single disk) suffer from poor usability. This is expected to change in a future update.

==== Non-functioning <code>zypper</code> after installation ====
There is currently a known issue that adds a non-functioning <code>zypper</code> repository which prevents <code>zypper</code> from working correctly.

To fix this issue, remove the repository in question and add the installation medium repository manually:
# Remove repository with <code>zypper rr</code>. To remove the first repository, for example, run: <code>zypper rr 1</code>.
# Add the installation medium as repository by running
#: <pre>zypper ar hd:/install?device=/dev/disk/by-label/agama-installer medium</pre>
#: (the <code>medium</code> at the end is a name you want to give the repository).
# Run <code>zypper refresh</code> to refresh the added repository.

==== systemd uses cgroup v2 by default ====
openSUSE Leap 16.0 uses cgroup v2 by default and v1 is unsupported. If you need to use cgroup v1, SLES 15 SP6 can be switched to hybrid mode using a boot parameter.

=== x86-64-specific changes ===
Information in this section applies to the x86-64 architecture.

==== AMD EPYC Turin automonous frequency scaling ====
In Leap 16.0, the default Linux CPU frequency scaling driver for AMD EPYC Turin (and later processors) has shifted to the AMD P-State driver to enable autonomous frequency scaling.

With the AMD P-State driver, it enables the use of the Energy Performance Preference (EPP) for more granular control over performance versus power efficiency to adjust the CPU frequencies based on workload and hardware feedback dynamically.

=== IBM Z-specific changes (s390x) ===
Information in this section applies to openSUSE Leap for IBM Z 16.0. For more information, see https://www.ibm.com/docs/en/linux-on-systems?topic=distributions-suse-linux-enterprise-server

==== Hardware ====
* Support has been added for IBM z17 in <code>kernel</code> providing machine name, kconfig options, new instructions, etc.
* Support has been added for IBM z17 in <code>gdb</code>, <code>valgrind</code>, <code>binutils</code>
* Support has been added for IBM z16 - reset DAT-Protection facility support
* Identify ConnectX devices through port rather than PCHID
* Processor Activity Instrumentation / Neural Network Processing Assist counters for new IBM Z hardware was added into kernel
* kprobes are now supported without <code>stop machine</code>
* Promiscuous Mode Exploitation for NETH Virtual Functions for IBM z17 and LinuxONE 5
* Vertical CPU Polarization support for IBM z17 and LinuxONE 5
* qclib has been updated to support IBM z17
* The Integrated Accelerator for AI has new operations, which are now supported by libzdnn low-level driver library
* Enhanced RAS and Call Home for zPCI
* The kernel image can move into vmalloc space, where random physical pages are used to map virtual pages (V!=R)
* Add new CPU-MF Counters for new IBM Z Hardware (libpfm)
* Deactivate CONFIG_QETH_OSX kernel config option
* Upgrade Mellanox (mlx5) driver to latest version

==== Performance ====
* LPAR level power consumption reporting is now available in kernel and s390-tools.

==== Security ====
===== In-kernel crypto support =====
With this service pack are additionally supported:
* MSA 10 XTS instructions for in-kernel crypto
* MSA 11 HMAC instructions for in-kernel crypto
* MSA 12 (SHA3) has been added and introduces new options to call CPACF SHA 3 functions
* MSA 11 HMAC instructions for in-kernel crypto
* MSA 10 XTS crypto PAES support for in-kernel crypto

===== OpenSSL features =====
This release brings these features and improvements:
* XTS instructions support in libcrypto/openSSL
* New MSA 11 HMAC instruction support in libcrypto/openSSL
* Added support for MSA 12 (SHA3), which also introduces new options to call CPACF SHA3 and SHKE functions
* Extended support of the openssl-pkcs11 provider such that it can be used by programs that issue forks
* Replace openssl-ibmpkcs11 with openssl-pkcs11
* Upgrade openssl-ibmca to the latest version

===== openCryptoki =====
* The new version of <code>libica</code> and <code>libzpc</code> is included.
* The openCryptoki CCA Token is now available on x86_64 and ppc64le architectures.

===== p11-kit =====
* Add support for IBM specific attributes and mechanisms to the PKCS11 client-server implementation of p11-kit.

===== pkey =====
* The kernel pkey module can now generate keys AES-XTS keys (MSA 10) and HMAC key (MSA 11) from clear keys.
* The module can also generate keys represented by identifiers of secure execution retrievable keys.
* The pkey also supports EP11 API ordinal 6 for secure guests.

===== zcrypt =====
* The zcrypt extends error recovery to deal with device scans of unavailable devices.

==== Virtualization ====
* KVM guests can exploit z17 & LinuxONE 5 CPU features
* KVM can display available host key hashes for Secure Execution (Query Host-key hash UVC)
* KVM can benefit from genprotimg rewritten in Rust to re-use existing rust libraries (s390-tools feature)
* KVM benefits from genprotimg validation of SE image running on particular host(s) (s390-tools feature)
* KVM benefits from using pvimg info command to display encrypted & unencrypted SE image information (s390-tools)
* KVM can use unencrypted SE images for creating generic images (s390-tools feature)
* KVM passthrough is available for guests i.e. retrievable secrets in Secure Execution guests
* KVM can use unencrypted SE images for creating generic images (s390-tools feature)
* KVM implements counters for nested guest shadow events
* KVM implements virsh hypervisor-cpu-models (libvirt)
* KVM provides enhanced and dynamic CPU topology for KVM guests (qemu)
* KVM and libvirt full boot order enables users to attempt booting from multiple targets
* KVM provides Atomic Memop for Key-Checked Compare-and-swap
* KVM enhances CCW address translation architectural compliance
* KVM improves memory reclaiming for z15 Secure Execution guests and above (libvirt)

==== Miscellaneous ====
* <code>plymouth</code> was replaced by <code>blog</code> on s390x, as <code>plymouth</code> couldn't work without graphical display.
* The <code>Eigen</code> library is the backend used by <code>Tensorflow</code> for computations executed on the CPU. Several GCC adjustments have been implemented to speed up Eigen with IBM z14 support and above.
* Allow <code>httpd</code> customers to protect their web server identity using HSMs (via CryptoExpress adapters).

===== Enhancements in <code>s390-tools</code> =====
The latest s390-tool update brings these noticeable changes:
* Additional channel measurements - kernel & <code>s390-tools</code>
* A new tool cpacinfo shall provide information on CPACF including the supported MSA levels, instructions, subfunctions per instruction. https://www.ibm.com/docs/en/linux-on-systems?topic=hw-cpacf

===== <code>parmfile</code> now points to ISO =====
Previously, <code>parmfile</code> would point to a directory of unpacked files.

Now it needs to point to a loop-mounted ISO via FTP. For example:
<pre>root=live:ftp://$SERVER_URL/install/agama-online.iso
agama.install_url=ftp://$SERVER_URL/install/agama</pre>
For more information see https://agama-project.github.io/docs/user/boot_options.

===== Disk selection UI problems during installation =====
If you want to enable a disk, click on ''Storage'' in the left panel, then ''Install new system on'' and choose "storage techs". Then you can choose a type of disk. This can be avoided if you have defined your <code>parmfile</code> as described in Section "<code>parmfile</code> now points to ISO".

If you choose DASD, you should see disks based on your <code>parmfile</code> and <code>cio_ignore</code> configuration. Then choose a disk and activate it by clicking ''Perform an action'' and then ''Activate''. This can take a moment. If it is not visible, then you need to click on Storage or refresh the page.

In the ''zFCP'' section, after activating a disk a gray line will appear. This is just a visual bug, the disk will activate correctly.

===== Installation failure on zVM =====
Due to a change from <code>linuxrc</code> to <code>dracut</code>, the <code>parmfile</code> needs to define not only installation source but also a network and disks.

The <code>parmfile</code> needs to be filled with a <code>dracut-like</code> options, for example:
<pre>root=live:ftp://$SERVER_URL/install/online.iso
ip=$IP_address::$IP_gateway:24:SLE16-Beta4:$NETWORK_DEVICE:none
rd.zdev=qeth,0.0.0800:0.0.0801:0.0.0802,layer2=1,portno=0
cio_ignore=all,!condev,!0.0.0160 nameserver=$NAMEserverIP
live.password=linux rd.zdev=dasd,0.0.0160</pre>

=== POWER-specific changes (ppc64le) ===
Information in this section applies to openSUSE Leap for POWER 16.0.

==== KVM guests in LPAR ====
The ability to run KVM Guests in an LPAR is a new feature in PowerVM Firmware 1060.10 release and supported in openSUSE Leap 16.0. This enables users to run KVM guests in a PowerVM LPAR bringing industry standard Linux KVM virtualization stack to IBM PowerVM, which easily integrates with existing Linux virtualization ecosystem. This enables a lot of interesting usecases which were earlier difficult to realize in a PowerVM LPAR.

KVM in a PowerVM LPAR is a new type of LPAR (logical partition) that allows the openSUSE Leap 16.0 kernel to host KVM guests inside an LPAR on PowerVM. A KVM enabled LPAR allows standard Linux KVM tools (for example, <code>virsh</code>) to create and manage lightweight Linux Virtual Machines (VM). A KVM Linux LPAR uses dedicated cores which enables Linux to have full control of when Linux VMs are scheduled to run, just like KVM on other platforms.

==== Login times out on HMC virtual terminal ====
If you install openSUSE Leap for POWER with the GNOME desktop on LPAR and try to login via the HMC virtual terminal, the login may time out while entering your credentials.

To work around this issue, disable the Plymouth graphical boot screen by appending the boot parameter <code>plymouth.enable=0</code> to the kernel command line.

=== Arm-specific changes (AArch64) ===
==== System-on-Chip driver enablement ====
Leap 16.0 includes driver enablement for the following System-on-Chip (SoC) chipsets:
* Ampere* X-Gene*, eMAG*, Altra*, Altra Max, AmpereOne*
* AWS* Graviton, Graviton2, Graviton3
* Broadcom* BCM2837/BCM2710, BCM2711
* Fujitsu* A64FX
* Huawei* Kunpeng* 916, Kunpeng 920
* Marvell* ThunderX*, ThunderX2*; OCTEON TX*; Armada* 7040, Armada 8040
* NVIDIA* Grace; Tegra* X1, Tegra X2, Xavier*, Orin; BlueField*, BlueField-2, BlueField-3
* NXP* i.MX 8M, 8M Mini; Layerscape* LS1012A, LS1027A/LS1017A, LS1028A/LS1018A, LS1043A, LS1046A, LS1088A, LS2080A/LS2040A, LS2088A, LX2160A
* Rockchip RK3399
* Socionext* SynQuacer* SC2A11
* Xilinx* Zynq* UltraScale*+ MPSoC

<div style="background:#C0C0C0;border:1px solid #666666;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Note'''

Driver enablement is done as far as available and requested. Refer to the following sections for any known limitations.
</div>

Some systems might need additional drivers for external chips, such as a Power Management Integrated Chip (PMIC), which may differ between systems with the same SoC chipset.

For booting, systems need to fulfill either the Server Base Boot Requirements (SBBR) or the Embedded Base Boot Requirements (EBBR), that is, the Unified Extensible Firmware Interface (UEFI) either implementing the Advanced Configuration and Power Interface (ACPI) or providing a Flat Device Tree (FDT) table. If both are implemented, the kernel will default to the Device Tree; the kernel command line argument <code>acpi=force</code> can override this default behavior.

Check for SUSE ''YES!'' certified systems, which have undergone compatibility testing.

=== Virtualization ===
* iSCSI boot support is disabled in OVMF images.

==== QEMU ====
QEMU has been updated to version 10.0.2, full list of changes are available at https://wiki.qemu.org/ChangeLog/10.0

Highlights include:
* Removed features: https://qemu-project.gitlab.io/qemu/about/removed-features.html
* Deprecated features: https://qemu-project.gitlab.io/qemu/about/deprecated.html

==== libvirt ====
<code>libvirt</code> has been updated to version 11.4.0, this includes many incremental improvements and bug fixes, see https://libvirt.org/news.html#v11-4-0-2025-06-02.

<code>libvirt</code> provides now a modular daemons.

==== VMware ====
===== <code>open-vm-tools</code> =====
<code>open-vm-tools</code> has been updated to version 13.0.0 that addresses a few critical problems and bug fixes. See https://github.com/vmware/open-vm-tools/blob/stable-13.0.0/ReleaseNotes.md.

==== Confidential Computing ====
===== <code>sevctl</code> =====
The <code>sevctl</code> package has been updated to version 0.6.0.

===== <code>snpguest</code> =====
The <code>snpguest</code> package has been updated to version 0.9.1. Full list of changes is available at: https://github.com/virtee/snpguest/compare/v0.7.1…v0.9.1

===== <code>snphost</code> =====
The <code>snphost</code> package version 0.6.0 has been added.

===== Intel TDX Confidential Computing =====
In openSUSE Leap 16.0 the kernel now incorporates the latest upstream Intel Trust Domain Extensions (TDX) patches. This significant update prepares the virtualization toolstack for Intel TDX confidential computing capabilities.

These patches are important for enabling the kernel to support creating and managing trust domains, which is a step towards enabling confidential computing environments on Intel TDX-enabled hardware.

<div style="background:#C0C0C0;border:1px solid #666666;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Note'''

The full Intel TDX confidential computing experience also requires integrating QEMU and libvirt components, which will be part of a future update.
</div>

===== Enhanced VM Security with AMD SEV-SNP =====
AMD SEV-SNP (Secure Encrypted Virtualization-Secure Nested Paging) is a hardware security feature in AMD EPYC processors that provides a highly secure and confidential environment for virtual machines (VMs). It offers strong memory confidentiality through per-VM encryption keys and AES encryption, and crucially, robust memory integrity protection to prevent tampering from the hypervisor or other threats. It also provides enhanced isolation and remote attestation capabilities, making it ideal for protecting sensitive data and workloads in untrusted environments like cloud computing. This release fully integrates AMD SEV-SNP for KVM-based virtual machines. This means integrated support in our kernel, along with updated QEMU, Libvirt, and OVMF Firmware. To use AMD SEV-SNP, you'll need, AMD EPYC™ 3rd Gen Processors (Milan) or newer and SEV-SNP enabled in your system's BIOS/UEFI.

==== Others ====
===== <code>numatop</code> =====
<code>numatop</code> is available in version 2.5, adding support for Intel GNR and SRF platforms.

===== <code>numactl</code> =====
<code>numactl</code> is shipped in version 2.0.19. Full changes at: https://github.com/numactl/numactl/releases/tag/v2.0.19

===== <code>libguestfs</code> =====
<code>libguestfs</code> has been updated to version 1.55.13.

===== <code>virt-v2v</code> =====
Update to version 2.7.16. While there are no dedicated release notes, you can review the code changes in Github: https://github.com/libguestfs/virt-v2v/tree/v2.7.16
* Implement --parallel=N for parallel disk copies
* Update Translations
* Various fixes

===== <code>virtiofsd</code> =====
The <code>virtiofsd</code> has been updated to 1.12.0.

===== <code>virt-manager</code> =====
<code>virt-manager</code> is now shipped in version 5.0.0. Its preferable to setup VNC for remote viewing and do all the XML editing using the <code>virsh</code> command. Full list of changes is available at https://github.com/virt-manager/virt-manager/releases/tag/v5.0.0

===== virt-bridge-setup =====
virt-bridge-setup is a script designed to simplify network bridge creation on a specified interface using nmcli. It was developed as a replacement for the automatic "yast2 virtualization" bridge creation and is particularly useful for setting up virtualization environments.

Important considerations:
* It supports IPv4 only.
* This is a simple script not intended for complex network scenarios (vlan, bonding, etc…); manual bridge setup is recommended for intricate configurations.
* The script should be run locally (not remotely) immediately after installation and before any custom network configurations.

=== Removed and deprecated features and packages ===
This section lists features and packages that were removed from openSUSE Leap or will be removed in upcoming versions.

==== Removed features and packages ====
The following features and packages have been removed in this release.
* Xorg server has been removed. Only Wayland is supported for graphical display. X11 applications compatibility is provided via XWayland.
* <code>sapconf</code> has been removed. See Section "<code>saptune</code> replaces <code>sapconf</code>" for more info.
* YaST has been removed. See Section "Switch from YaST to Cockpit" for more info.
* WSL1 is not supported anymore
* The Xen hypervisor was removed in favor of KVM. You no longer run SLE 16 as Xen host or as paravirtualized guest (PV). Running SLE 16 as fully virtualized Xen guest (HVM) or using using hardware virtualization features (PVH) is still possible.
* <code>nscd</code> has been removed
* The snIPL package is deprecated as HMC is providing most capabilities. There is also available a command line client to interact with the HMC Web Services API: the zhmccli https://github.com/zhmcclient.
* Removed <code>rc<service></code> controls of systemd services
* Removed the <code>KBD_DISABLE_CAPS_LOCK</code> feature from <code>/etc/sysconfig/keyboard</code>
* <code>netiucv</code> and <code>lcs</code> drivers
* <code>ansible-9</code> and <code>ansible-core-2.16</code>
* <code>criu</code>
* Section "SysV init.d scripts support"
* <code>compat-libpthread-nonshared</code>
* <code>crun</code> has been removed. Use <code>runc</code> instead.

=== Deprecated features and packages ===
The following features and packages are deprecated and will be removed in a future version of openSUSE Leap.
* The 2MB OVMF image will be deprecated and removed in openSUSE Leap 16.1.

==== nmap deprecation notice ====
The nmap project has moved to a new source license that makes future releases of nmap incompatible with our product.

In Leap 16.0, we are shipping the latest version of nmap released under the old license. In an upcoming release we will switch to an alternative tool.

== Obtaining source code ==
This SUSE product includes materials licensed to SUSE under the GNU General Public License (GPL). The GPL requires SUSE to provide the source code that corresponds to the GPL-licensed material. The source code is available for download at https://get.opensuse.org on Medium 2. For up to three years after distribution of the SUSE product, upon request, SUSE will mail a copy of the source code. Send requests by e-mail to sle_source_request@suse.com. SUSE may charge a reasonable fee to recover distribution costs.

== Legal notices ==
Copyright © 2025-2025 openSUSE contributors and SUSE LLC. All rights reserved.

Permission is granted to copy, distribute, and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) Version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled "GNU Free Documentation License".

This document includes content adapted from the SUSE Linux Enterprise release notes, contributed by the SUSE Documentation Team. Portions of the content are maintained by the openSUSE community.

For SUSE trademarks, see https://www.suse.com/company/legal/. For openSUSE trademarks, see https://en.opensuse.org/openSUSE:Trademark_guidelines. All other third-party trademarks are the property of their respective owners. Trademark symbols (®, ™, etc.) denote trademarks of SUSE, openSUSE, and their affiliates. Asterisks (*) denote third-party trademarks.

While every effort has been made to ensure accuracy, the openSUSE contributors, SUSE Documentation Team, and authors assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

Obtaining openSUSE 16.0

2026-07-01T14:58:34Z

Sam: Corrected incorrect showing link

[[openSUSE Leap 16.0]] is available from the following locations:

* https://www.opensuse.org/, click 'Leap' then 'Install Leap'
** DVD/USB installation - this is the most common download option and needed for conventional installations. (Direct/Torrent)
** Network installation - installs the system from an internet repository or network repository. (Direct/Torrent)
* If I have already downloaded an ISO, they are currently available at \\thinkserver\Build\CD Images\ via Samba/Windows File share.
* The ISO needs to be put onto a USB Stick and made into a bootable USB drive. This method completely wipes the stick and needs the computer to support booting from USB. However, this method makes the installation a lot faster than optical media. On Windows, the recommended method is to use [https://rufus.ie/ Rufus] in DD writing mode.
* They can also be burned to a DVD. The image itself needs burning, not the image file. For more information, see [[burning a CD/DVD image]].

'''NOTE: 32-bit builds are no longer available, only 64-bit is supported (most modern CPU's support 64-bit, late generation Intel Pentium 4's and all Core processors will support x86_64). If you require 32-bit, you must use the [[openSUSE Tumbleweed]] distribution.'''

'''NOTE: x86_64 builds require an microarchitecture level of at least x86_84 v2 (at least Intel Core i3/5/7 1st generation) to install as of openSUSE 16.0.'''

== Download links ==

'''NOTE: SHA-256 values removed as links download latest build available at the time, which may not match the SHA-256 values if kept here.'''

These should be available during the lifetime of this version:

=== Intel or AMD 64-bit desktops, laptops, and servers (x86_64) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-x86_64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-x86_64.install.iso.torrent

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-x86_64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-x86_64.install.iso.torrent

=== UEFI ARM 64-bit servers, desktops, laptops and boards (aarch64) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-aarch64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-aarch64.install.iso.torrent

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-aarch64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-aarch64.install.iso.torrent

=== PowerPC servers, not big-endian (ppc64le) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-ppc64le.install.iso

Torrent: Not available at launch

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-ppc64le.install.iso

Torrent: Not available at launch

=== IBM zSystems and LinuxONE (s390x) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-s390x.install.iso

Torrent: Not available at launch

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-s390x.install.iso

Torrent: Not available at launch

Obtaining openSUSE 16.0

2026-07-01T14:57:49Z

Sam: Recreated lost page through Wayback Machine

[[openSUSE Leap 16.0]] is available from the following locations:

* [https://www.opensuse.org/], click 'Leap' then 'Install Leap'
** DVD/USB installation - this is the most common download option and needed for conventional installations. (Direct/Torrent)
** Network installation - installs the system from an internet repository or network repository. (Direct/Torrent)
* If I have already downloaded an ISO, they are currently available at \\thinkserver\Build\CD Images\ via Samba/Windows File share.
* The ISO needs to be put onto a USB Stick and made into a bootable USB drive. This method completely wipes the stick and needs the computer to support booting from USB. However, this method makes the installation a lot faster than optical media. On Windows, the recommended method is to use [https://rufus.ie/ Rufus] in DD writing mode.
* They can also be burned to a DVD. The image itself needs burning, not the image file. For more information, see [[burning a CD/DVD image]].

'''NOTE: 32-bit builds are no longer available, only 64-bit is supported (most modern CPU's support 64-bit, late generation Intel Pentium 4's and all Core processors will support x86_64). If you require 32-bit, you must use the [[openSUSE Tumbleweed]] distribution.'''

'''NOTE: x86_64 builds require an microarchitecture level of at least x86_84 v2 (at least Intel Core i3/5/7 1st generation) to install as of openSUSE 16.0.'''

== Download links ==

'''NOTE: SHA-256 values removed as links download latest build available at the time, which may not match the SHA-256 values if kept here.'''

These should be available during the lifetime of this version:

=== Intel or AMD 64-bit desktops, laptops, and servers (x86_64) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-x86_64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-x86_64.install.iso.torrent

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-x86_64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-x86_64.install.iso.torrent

=== UEFI ARM 64-bit servers, desktops, laptops and boards (aarch64) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-aarch64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-aarch64.install.iso.torrent

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-aarch64.install.iso

Torrent: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-aarch64.install.iso.torrent

=== PowerPC servers, not big-endian (ppc64le) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-ppc64le.install.iso

Torrent: Not available at launch

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-ppc64le.install.iso

Torrent: Not available at launch

=== IBM zSystems and LinuxONE (s390x) ===

==== DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-offline-installer-s390x.install.iso

Torrent: Not available at launch

==== Network Install DVD ====

Direct: https://download.opensuse.org/distribution/leap/16.0/offline/Leap-16.0-online-installer-s390x.install.iso

Torrent: Not available at launch

Template:Current openSUSE

2026-07-01T14:49:42Z

Sam: Changed to openSUSE 16.0

[[openSUSE Leap 16.0]]

File:OpenSUSE Leap 16.0 webpage.webp

2026-07-01T14:48:52Z

Sam: Original summary - "Screenshot taken with scrollbar in correct location at the top of the page".

== Summary ==
Original summary - "Screenshot taken with scrollbar in correct location at the top of the page".

OpenSUSE Leap 16.0

2026-07-01T14:48:04Z

Sam: Added webpage image

This is the Linux distribution my server is based on. More information is available [https://www.opensuse.org/ here].

If you are looking to install openSUSE, there are more details in [[obtaining openSUSE 16.0]].

== Changes to openSUSE ==
=== YaST deprication ===

YaST is no longer being developed by SuSE and therefore is not being developed for openSUSE. Therefore, YaST is not available in openSUSE 16.0. openSUSE 16.0 now uses Myrlyn for package management and Cockpit for most other things YaST used to do.

=== New installer ===

Agama is the new web based installer for openSUSE when installing via ISO image. There is also a migration tool available in previous versions that takes care of the full migration to openSUSE 16.0 automatically and painlessly.

=== Wayland compositor by default ===

openSUSE 16.0 no longer uses X and defaults to using Wayland as the desktop compositor. To use X as before, this must be installed yourself but do note, this is deprecated.

=== AppArmor no longer default ===

AppArmor is no longer the default security solution, SELinux is now the preferred security solution for openSUSE 16.0. AppArmor can, however, still be used if preferred.

== Installation notes/Known Issues ===

* If upgrading, check the "Unneeded Packages" category in Myrlyn once upgraded to remove any lingering unneeded packages from the previous version.

== Release notes ==

[[OpenSUSE Leap 16.0 Release Notes|Release Notes]]

== Information ==

openSUSE Leap 16.0 was released on 1st October 2025. It is an open-source distribution and is free of charge. It is developed by the community and sponsored by [https://www.eqtgroup.com/ EQT Partners] (formally Micro Focus and Novell).

== Previous supported versions (at time of release) ==

* openSUSE Leap 15.6 (Supported until 30th April 2026)
* openSUSE Tumbleweed (Rolling release)
<br>
[[File:openSUSE Leap 16.0 webpage.webp|center|400px]]

OpenSUSE Leap 16.0

2026-07-01T14:45:33Z

Sam: Recreated lost page through Wayback Machine

This is the Linux distribution my server is based on. More information is available [https://www.opensuse.org/ here].

If you are looking to install openSUSE, there are more details in [[obtaining openSUSE 16.0]].

== Changes to openSUSE ==
=== YaST deprication ===

YaST is no longer being developed by SuSE and therefore is not being developed for openSUSE. Therefore, YaST is not available in openSUSE 16.0. openSUSE 16.0 now uses Myrlyn for package management and Cockpit for most other things YaST used to do.

=== New installer ===

Agama is the new web based installer for openSUSE when installing via ISO image. There is also a migration tool available in previous versions that takes care of the full migration to openSUSE 16.0 automatically and painlessly.

=== Wayland compositor by default ===

openSUSE 16.0 no longer uses X and defaults to using Wayland as the desktop compositor. To use X as before, this must be installed yourself but do note, this is deprecated.

=== AppArmor no longer default ===

AppArmor is no longer the default security solution, SELinux is now the preferred security solution for openSUSE 16.0. AppArmor can, however, still be used if preferred.

== Installation notes/Known Issues ===

* If upgrading, check the "Unneeded Packages" category in Myrlyn once upgraded to remove any lingering unneeded packages from the previous version.

== Release notes ==

[[OpenSUSE Leap 16.0 Release Notes|Release Notes]]

== Information ==

openSUSE Leap 16.0 was released on 1st October 2025. It is an open-source distribution and is free of charge. It is developed by the community and sponsored by [https://www.eqtgroup.com/ EQT Partners] (formally Micro Focus and Novell).

== Previous supported versions (at time of release) ==

* openSUSE Leap 15.6 (Supported until 30th April 2026)
* openSUSE Tumbleweed (Rolling release)

OpenSUSE Tumbleweed

2025-08-01T14:14:47Z

Sam: /* About openSUSE Tumbleweed */ Corrected openSUSE link

More information is available [https://www.opensuse.org/ here]. If you are looking to install openSUSE, there are more details in [[Obtaining openSUSE Tumbleweed|obtaining openSUSE Tumbleweed]].

== About openSUSE Tumbleweed ==

[[File:Tumbleweed.png|right]]

openSUSE Tumbleweed is a rolling distribution of openSUSE. It is kept up to date with the latest packages, while maintaining a degree of stability. Although not as unstable as the bleeding edge factory build (which usually includes the very latest and beta builds of packages), it is not considered as stable as the main openSUSE distribution. That being said, issues are usually fixed pretty quick due to the rolling nature of this release.

In 2019, we moved to openSUSE Tumbleweed in place of [[openSUSE Leap 15.1]]. Due to the pace of change with internet security, a number of new features that we wanted on the server were not available in the normal openSUSE Leap releases without causing too much disruption to the normal release model. Some of the new features we want to take advantage of include:

* TLS 1.3 support in Apache
* openSSL 1.1.1 support, allowing TLS 1.3 support
* Strongswan modern charon support, moving away from the old ipsec model of support

[[openSUSE Leap 15.2]] includes these packages as stable releases and we moved back to Leap for that release (we was set for using what would have been openSUSE Leap 16 (now [[openSUSE Leap 15.4]]), however, our needs were met in openSUSE Leap 15.2).

== Known Issues ==

* <s>16th January 2020 - Nextcloud 17 and Piwigo are incompatible with the latest PHP 7.4 installed by openSUSE Leap. We are awaiting updates from the developers to address these issues</s> - These are now compatible with PHP 7.4

* No known issues at present

== Information ==

openSUSE Tumbleweed is an open-source distribution and is free of charge. It was founded by [https://www.novell.com/home/ Novell] and is developed by the community and sponsored by SUSE, a subsidiary of EQT Partners, Sweden.

[[File:OpenSUSE_Leap_42.1_website.png|500px|center]]

OpenSUSE Support List

2025-07-27T02:02:21Z

Sam: /* Currently supported */ Corrected EOL date

== Future release ==

{| class="wikitable"
|-
! openSUSE Version !! Expected release date
|-
| ''openSUSE Leap 16.0'' || ''1st October 2025''
|-
|}

== Currently supported ==

{| class="wikitable"
|-
! openSUSE Version !! Expected discontinued date
|-
| '''[[openSUSE Leap 15.6]] || '''30th April 2026'''
|-
| '''[[openSUSE Tumbleweed]]''' || '''Rolling release (supported if updated)'''
|}

== Discontinued ==

{| class="wikitable"
|-
! openSUSE version !! Discontinued date
|-
| [[openSUSE Leap 15.5]] || 31st December 2024
|-
| [[openSUSE Leap 15.4]] || 30th November 2023
|-
| [[openSUSE Leap 15.3]] || 31st December 2022
|-
| [[openSUSE Leap 15.2]] || 4th January 2022
|-
| [[openSUSE Leap 15.1]] || 2nd February 2021**
|-
| [[openSUSE Leap 15.0]] || 3rd December 2019
|-
| [[openSUSE Leap 42.3]] || 1st July 2019
|-
| [[openSUSE Leap 42.2]] || 26th January 2018
|-
| [[openSUSE Leap 42.1]] || 17th May 2017
|-
| [[openSUSE 13.2]] || 17th January 2017
|-
| [[openSUSE 13.1]]* || 3rd February 2016
|-
| [[openSUSE 12.3]] || 29th January 2015
|-
| [[openSUSE 12.2]] || 15th January 2014
|-
| [[openSUSE 12.1]] || 15th May 2013
|-
| [[openSUSE 11.4]]* || 5th November 2012
|-
| openSUSE 11.3 || 20th January 2012
|-
| openSUSE 11.2* || 12th May 2011
|-
| openSUSE 11.1* || 14th January 2011
|-
| openSUSE 11.0 || 26th July 2010
|-
| openSUSE 10.3 || 31st October 2009
|-
| openSUSE 10.2 || 30th November 2008
|-
| SUSE Linux 10.1 || 31st May 2008
|-
| SUSE Linux 10.0 || 30th November 2007
|-
| SUSE Linux 9.3 || 30th April 2007
|-
| SUSE Linux 9.2 || 31st October 2006
|-
| SUSE Linux 9.1 || 30th June 2006
|}

<nowiki>*</nowiki> = Evergreen was supported on this release. All Evergreen support has been stopped.<br>
<nowiki>**</nowiki> = Date originally November 2020 but changed due to the worldwide COVID-19 pandemic.

OpenSUSE Support List

2025-07-27T02:00:53Z

Sam: /* Currently supported */ Bolded date

== Future release ==

{| class="wikitable"
|-
! openSUSE Version !! Expected release date
|-
| ''openSUSE Leap 16.0'' || ''1st October 2025''
|-
|}

== Currently supported ==

{| class="wikitable"
|-
! openSUSE Version !! Expected discontinued date
|-
| '''[[openSUSE Leap 15.6]] || '''31st December 2025'''
|-
| '''[[openSUSE Tumbleweed]]''' || '''Rolling release (supported if updated)'''
|}

== Discontinued ==

{| class="wikitable"
|-
! openSUSE version !! Discontinued date
|-
| [[openSUSE Leap 15.5]] || 31st December 2024
|-
| [[openSUSE Leap 15.4]] || 30th November 2023
|-
| [[openSUSE Leap 15.3]] || 31st December 2022
|-
| [[openSUSE Leap 15.2]] || 4th January 2022
|-
| [[openSUSE Leap 15.1]] || 2nd February 2021**
|-
| [[openSUSE Leap 15.0]] || 3rd December 2019
|-
| [[openSUSE Leap 42.3]] || 1st July 2019
|-
| [[openSUSE Leap 42.2]] || 26th January 2018
|-
| [[openSUSE Leap 42.1]] || 17th May 2017
|-
| [[openSUSE 13.2]] || 17th January 2017
|-
| [[openSUSE 13.1]]* || 3rd February 2016
|-
| [[openSUSE 12.3]] || 29th January 2015
|-
| [[openSUSE 12.2]] || 15th January 2014
|-
| [[openSUSE 12.1]] || 15th May 2013
|-
| [[openSUSE 11.4]]* || 5th November 2012
|-
| openSUSE 11.3 || 20th January 2012
|-
| openSUSE 11.2* || 12th May 2011
|-
| openSUSE 11.1* || 14th January 2011
|-
| openSUSE 11.0 || 26th July 2010
|-
| openSUSE 10.3 || 31st October 2009
|-
| openSUSE 10.2 || 30th November 2008
|-
| SUSE Linux 10.1 || 31st May 2008
|-
| SUSE Linux 10.0 || 30th November 2007
|-
| SUSE Linux 9.3 || 30th April 2007
|-
| SUSE Linux 9.2 || 31st October 2006
|-
| SUSE Linux 9.1 || 30th June 2006
|}

<nowiki>*</nowiki> = Evergreen was supported on this release. All Evergreen support has been stopped.<br>
<nowiki>**</nowiki> = Date originally November 2020 but changed due to the worldwide COVID-19 pandemic.

OpenSUSE Support List

2025-07-27T02:00:23Z

Sam: /* Expected release */ Changed expected to future

== Future release ==

{| class="wikitable"
|-
! openSUSE Version !! Expected release date
|-
| ''openSUSE Leap 16.0'' || ''1st October 2025''
|-
|}

== Currently supported ==

{| class="wikitable"
|-
! openSUSE Version !! Expected discontinued date
|-
| '''[[openSUSE Leap 15.6]] || 31st December 2025
|-
| '''[[openSUSE Tumbleweed]]''' || '''Rolling release (supported if updated)'''
|}

== Discontinued ==

{| class="wikitable"
|-
! openSUSE version !! Discontinued date
|-
| [[openSUSE Leap 15.5]] || 31st December 2024
|-
| [[openSUSE Leap 15.4]] || 30th November 2023
|-
| [[openSUSE Leap 15.3]] || 31st December 2022
|-
| [[openSUSE Leap 15.2]] || 4th January 2022
|-
| [[openSUSE Leap 15.1]] || 2nd February 2021**
|-
| [[openSUSE Leap 15.0]] || 3rd December 2019
|-
| [[openSUSE Leap 42.3]] || 1st July 2019
|-
| [[openSUSE Leap 42.2]] || 26th January 2018
|-
| [[openSUSE Leap 42.1]] || 17th May 2017
|-
| [[openSUSE 13.2]] || 17th January 2017
|-
| [[openSUSE 13.1]]* || 3rd February 2016
|-
| [[openSUSE 12.3]] || 29th January 2015
|-
| [[openSUSE 12.2]] || 15th January 2014
|-
| [[openSUSE 12.1]] || 15th May 2013
|-
| [[openSUSE 11.4]]* || 5th November 2012
|-
| openSUSE 11.3 || 20th January 2012
|-
| openSUSE 11.2* || 12th May 2011
|-
| openSUSE 11.1* || 14th January 2011
|-
| openSUSE 11.0 || 26th July 2010
|-
| openSUSE 10.3 || 31st October 2009
|-
| openSUSE 10.2 || 30th November 2008
|-
| SUSE Linux 10.1 || 31st May 2008
|-
| SUSE Linux 10.0 || 30th November 2007
|-
| SUSE Linux 9.3 || 30th April 2007
|-
| SUSE Linux 9.2 || 31st October 2006
|-
| SUSE Linux 9.1 || 30th June 2006
|}

<nowiki>*</nowiki> = Evergreen was supported on this release. All Evergreen support has been stopped.<br>
<nowiki>**</nowiki> = Date originally November 2020 but changed due to the worldwide COVID-19 pandemic.

OpenSUSE Support List

2025-05-29T20:13:53Z

Sam: Added expected release date for openSUSE 16.0

== Expected release ==

{| class="wikitable"
|-
! openSUSE Version !! Expected release date
|-
| ''openSUSE Leap 16.0'' || ''1st October 2025''
|-
|}

== Currently supported ==

{| class="wikitable"
|-
! openSUSE Version !! Expected discontinued date
|-
| '''[[openSUSE Leap 15.6]] || 31st December 2025
|-
| '''[[openSUSE Tumbleweed]]''' || '''Rolling release (supported if updated)'''
|}

== Discontinued ==

{| class="wikitable"
|-
! openSUSE version !! Discontinued date
|-
| [[openSUSE Leap 15.5]] || 31st December 2024
|-
| [[openSUSE Leap 15.4]] || 30th November 2023
|-
| [[openSUSE Leap 15.3]] || 31st December 2022
|-
| [[openSUSE Leap 15.2]] || 4th January 2022
|-
| [[openSUSE Leap 15.1]] || 2nd February 2021**
|-
| [[openSUSE Leap 15.0]] || 3rd December 2019
|-
| [[openSUSE Leap 42.3]] || 1st July 2019
|-
| [[openSUSE Leap 42.2]] || 26th January 2018
|-
| [[openSUSE Leap 42.1]] || 17th May 2017
|-
| [[openSUSE 13.2]] || 17th January 2017
|-
| [[openSUSE 13.1]]* || 3rd February 2016
|-
| [[openSUSE 12.3]] || 29th January 2015
|-
| [[openSUSE 12.2]] || 15th January 2014
|-
| [[openSUSE 12.1]] || 15th May 2013
|-
| [[openSUSE 11.4]]* || 5th November 2012
|-
| openSUSE 11.3 || 20th January 2012
|-
| openSUSE 11.2* || 12th May 2011
|-
| openSUSE 11.1* || 14th January 2011
|-
| openSUSE 11.0 || 26th July 2010
|-
| openSUSE 10.3 || 31st October 2009
|-
| openSUSE 10.2 || 30th November 2008
|-
| SUSE Linux 10.1 || 31st May 2008
|-
| SUSE Linux 10.0 || 30th November 2007
|-
| SUSE Linux 9.3 || 30th April 2007
|-
| SUSE Linux 9.2 || 31st October 2006
|-
| SUSE Linux 9.1 || 30th June 2006
|}

<nowiki>*</nowiki> = Evergreen was supported on this release. All Evergreen support has been stopped.<br>
<nowiki>**</nowiki> = Date originally November 2020 but changed due to the worldwide COVID-19 pandemic.

OpenSUSE Leap 15.5

2025-04-03T16:04:18Z

Sam: Added no support

{{No support}}
This is the Linux distribution my server was based on. More information is available [https://www.opensuse.org/ here].

If you are looking to install openSUSE, you should look at installing {{Current openSUSE}}, the latest version.

If you are still looking to install openSUSE, there are more details in [[obtaining openSUSE Leap 15.5]].

== Changes to openSUSE ==

Starting with Leap 42.1, work commenced to align openSUSE Leap's code using SUSE Enterprise Linux as the base code. This [https://www.suse.com/c/closing-the-leap-gap-src/ Closing the Leap Gap] project has finally taken shape in openSUSE 15.3 with this release using SUSE Linux Enterprise packages where possible. You will notice this with the additional update repositories that are added in this release. This will allow stable releases to be built based on the rock solid reliability of SUSE Linux Enterprise.

Releases are now in line with SUSE Enterprise Linux, with openSUSE 15.4, openSUSE 15.5 and openSUSE 15.6 now expected to align with the SUSE Enterprise Linux releases instead of the anticipated jump to openSUSE 16.0 as would have happened before.

32-bit versions are no longer available, only 64-bit (x86_64) now. SUSE Enterprise Linux has not supported 32-bit for a long time and being more in line with SUSE Enterprise Linux, openSUSE now shares this trait. Most modern CPU's now support 64-bit (Intel Pentium 4's with the Prescott 2M core from 2005 onwards support x86_64). The rolling release, [[openSUSE Tumbleweed]] still supports 32-bit versions if needed.

== Installation notes/Known Issues ==

Due to the Closing the Leap Gap Project, there have been some major changes within the system that have presented issues while installing this version.

* If upgrading, check the "Unneeded Packages" category in YaST once upgraded to remove any lingering unneeded packages from the previous version.
* MariaDB now uses system authentication for the root user - just login as root then type <code>mariadb</code>. You will be logged in automatically. This differs from before where the root password needed setting before you could use it.
* To enable TLS in Apache, the following flags need adding to <code>sysconfig</code>. Edit <code>/etc/sysconfig/apache2</code> and edit this line:<br>
APACHE_SERVER_FLAGS="SSL HTTP2"
* YaST does not prompt for a root user password for Samba as previous versions did. This can be set up manually with <code>smbpasswd -a root</code>.
* <code>samba-ad-dc</code> has been removed from this release. It was removed from SuSE Linux 15 SP5 as it was only a technical preview so does not appear in openSUSE Leap 15.5. This is important if you implemented AD DC in previous versions.

== Release notes ==

[[openSUSE Leap 15.5 Release Notes|Release Notes]]

== Information ==

openSUSE Leap 15.5 was released on 7th June 2023. It is an open-source distribution and is free of charge. It is developed by the community and sponsored by [https://www.eqtgroup.com/ EQT Partners] (formally Micro Focus and Novell).

== Previous supported versions (at time of release) ==

* [[openSUSE Leap 15.4]] (Supported until 30th November 2023)
* [[openSUSE Tumbleweed]] (Rolling release)
<br>
[[File:OpenSUSE_webpage_Leap_15.5.webp|center|400px]]

OpenSUSE Leap 15.4

2025-04-03T16:03:48Z

Sam: Added no support

{{No support}}
This is the Linux distribution my server was based on. More information is available [https://www.opensuse.org/ here].

If you are looking to install openSUSE, you should look at installing {{Current openSUSE}}, the latest version.

If you are still looking to install openSUSE, there are more details in [[obtaining openSUSE Leap 15.4]].

== Changes to openSUSE ==

Starting with Leap 42.1, work commenced to align openSUSE Leap's code using SUSE Enterprise Linux as the base code. This "[https://www.suse.com/c/closing-the-leap-gap-src/ Closing the Leap Gap]" project has finally taken shape in openSUSE 15.3 with this release using SUSE Linux Enterprise packages where possible. You will notice this with the additional update repositories that are added in this release. This will allow stable releases to be built based on the rock solid reliability of SUSE Linux Enterprise.

Releases are now in line with SUSE Enterprise Linux, with openSUSE 15.4 and openSUSE 15.5 now expected to align with the SUSE Enterprise Linux releases instead of the anticipated jump to openSUSE 16.0 as would have happened before.

32-bit versions are no longer available, only 64-bit (x86_64) now. SUSE Enterprise Linux has not supported 32-bit for a long time and being more in line with SUSE Enterprise Linux, openSUSE now shares this trait. Most modern CPU's now support 64-bit (Intel Pentium 4's with the Prescott 2M core from 2005 onwards support x86_64). The rolling release, [[openSUSE Tumbleweed]] still supports 32-bit versions if needed.

== Installation notes/Known Issues ==

Due to the Closing the Leap Gap Project, there have been some major changes within the system that have presented issues while installing this version.

* If upgrading, check the "Unneeded Packages" category in YaST once upgraded to remove any lingering unneeded packages from the previous version.
* PHP 8 is available in this release but not supported by all web software at present due to a major version change (namely Mediawiki 1.38.x). PHP 7 is still available for install in the meantime.
* MariaDB now uses system authentication for the root user - just login as root then type <code>mariadb</code>. You will be logged in automatically. This differs from before where the root password needed setting before you could use it.
* To enable TLS in Apache, the following flags need adding to <code>sysconfig</code>. Edit <code>/etc/sysconfig/apache2</code> and edit this line:<br>
APACHE_SERVER_FLAGS="SSL HTTP2"
* Crashplan has issues with this version of openSUSE. These can be resolved [[Code42 Crashplan|here]].
* YaST does not prompt for a root user password for Samba as previous versions did. This can be set up manually with <code>smbpasswd -a root</code>.

== Release notes ==

[[openSUSE Leap 15.4 Release Notes|Release Notes]]

== Information ==

openSUSE Leap 15.4 was released on 9th June 2022. It is an open-source distribution and is free of charge. It is developed by the community and sponsored by [https://www.eqtgroup.com/ EQT Partners] (formally Micro Focus and Novell).

== Previous supported versions (at time of release) ==

* [[openSUSE Leap 15.3]] (Supported until November 2022)
* [[openSUSE Tumbleweed]] (Rolling release)
<br>
[[File:OpenSUSE_webpage_Leap_15.4.png|center|400px]]

OpenSUSE Leap 15.3

2025-04-03T16:03:12Z

Sam: Added no support

{{No support}}
This is the Linux distribution my server was based on. More information is available [https://www.opensuse.org/ here].

If you are looking to install openSUSE, you should look at installing {{Current openSUSE}}, the latest version.

If you are still looking to install openSUSE, there are more details in [[obtaining openSUSE Leap 15.3]].

== Changes to openSUSE ==

Starting with Leap 42.1, work commenced to align openSUSE Leap's code using SUSE Enterprise Linux as the base code. This "[https://www.suse.com/c/closing-the-leap-gap-src/ Closing the Leap Gap]" project has finally taken shape in openSUSE 15.3 with this release using SUSE Linux Enterprise packages where possible. You will notice this with the additional update repositories that are added in this release. This will allow stable releases to be built based on the rock solid reliability of SUSE Linux Enterprise.

Releases are now in line with SUSE Enterprise Linux, with openSUSE 15.4 and possibly openSUSE 15.5 now expected to align with the SUSE Enterprise Linux releases instead of the anticipated jump to openSUSE 16.0 as would have happened before after this release.

32-bit versions are no longer available, only 64-bit (x86_64) now. SUSE Enterprise Linux has not supported 32-bit for a long time and being more in line with SUSE Enterprise Linux, openSUSE now shares this trait. Most modern CPU's now support 64-bit (Intel Pentium 4's with the Prescott 2M core from 2005 onwards support x86_64). The rolling release, [[openSUSE Tumbleweed]] still supports 32-bit versions if needed.

== Installation notes/Known Issues ==

* If upgrading, check the "Unneeded Packages" category in YaST once upgraded to remove any lingering unneeded packages from the previous version.
* Additional SLE update repositories need to be added if upgrading owing to the "[https://www.suse.com/c/closing-the-leap-gap-src/ Closing the Leap Gap]" project.
* No other issues at present

== Release notes ==

[[openSUSE Leap 15.3 Release Notes|Release Notes]]

== Information ==

openSUSE Leap 15.3 was released on 2nd June 2021. It is an open-source distribution and is free of charge. It is developed by the community and sponsored by [https://www.eqtgroup.com/ EQT Partners] (formally Micro Focus and Novell).

== Previous supported versions (at time of release) ==

* [[openSUSE Leap 15.2]] (Supported until December 2021)
* [[openSUSE Tumbleweed]] (Rolling release)

[[File:OpenSUSE_webpage_Leap_15.3.webp|center|400px]]

OpenSUSE Leap 15.2

2025-04-03T16:02:47Z

Sam: Added not support

OpenSUSE Leap 15.1

2025-04-03T16:02:10Z

Sam: Added no support

{{No support}}
This release was skipped on the server as we used [[openSUSE Tumbleweed]] to meet our needs. The next supported Leap release that we used is [[openSUSE Leap 15.2]].

OpenSUSE Support List

2025-04-03T16:00:34Z

Sam: Moved openSUSE Leap 15.5 to discontinued

== Currently supported ==

{| class="wikitable"
|-
! openSUSE Version !! Expected discontinued date
|-
| '''[[openSUSE Leap 15.6]] || 31st December 2025
|-
| '''[[openSUSE Tumbleweed]]''' || '''Rolling release (supported if updated)'''
|}

== Discontinued ==

{| class="wikitable"
|-
! openSUSE version !! Discontinued date
|-
| [[openSUSE Leap 15.5]] || 31st December 2024
|-
| [[openSUSE Leap 15.4]] || 30th November 2023
|-
| [[openSUSE Leap 15.3]] || 31st December 2022
|-
| [[openSUSE Leap 15.2]] || 4th January 2022
|-
| [[openSUSE Leap 15.1]] || 2nd February 2021**
|-
| [[openSUSE Leap 15.0]] || 3rd December 2019
|-
| [[openSUSE Leap 42.3]] || 1st July 2019
|-
| [[openSUSE Leap 42.2]] || 26th January 2018
|-
| [[openSUSE Leap 42.1]] || 17th May 2017
|-
| [[openSUSE 13.2]] || 17th January 2017
|-
| [[openSUSE 13.1]]* || 3rd February 2016
|-
| [[openSUSE 12.3]] || 29th January 2015
|-
| [[openSUSE 12.2]] || 15th January 2014
|-
| [[openSUSE 12.1]] || 15th May 2013
|-
| [[openSUSE 11.4]]* || 5th November 2012
|-
| openSUSE 11.3 || 20th January 2012
|-
| openSUSE 11.2* || 12th May 2011
|-
| openSUSE 11.1* || 14th January 2011
|-
| openSUSE 11.0 || 26th July 2010
|-
| openSUSE 10.3 || 31st October 2009
|-
| openSUSE 10.2 || 30th November 2008
|-
| SUSE Linux 10.1 || 31st May 2008
|-
| SUSE Linux 10.0 || 30th November 2007
|-
| SUSE Linux 9.3 || 30th April 2007
|-
| SUSE Linux 9.2 || 31st October 2006
|-
| SUSE Linux 9.1 || 30th June 2006
|}

<nowiki>*</nowiki> = Evergreen was supported on this release. All Evergreen support has been stopped.<br>
<nowiki>**</nowiki> = Date originally November 2020 but changed due to the worldwide COVID-19 pandemic.

CPU feature flags

2024-12-15T16:56:28Z

Sam: Added missing definitions

These are the explanations for the CPU flags available in Linux under Hardware information.

{| class="wikitable" border="1"
|-
! CPU flag
! Flag meaning
|-
| 3DNOW
| A multimedia extension created by AMD for its processors, based on/almost equivalent to Intel's MMX extensions.
|-
| 3DNOWEXT
| 3DNOW Extended. Also known as AMD's 3DNow! Enhanced/3DNow! Extensions.
|-
| APIC
| Advanced Programmable Interrupt Controller.
|-
| CLFSH/CLFlush
| Cache Line Flush.
|-
| CMOV
| Conditional Move/Compare Instruction.
|-
| CMP_Legacy
| Register showing the CPU is not Hyper-Threading capable.
|-
| Constant_TSC
| On Intel Pentium 4's, the TSC runs with constant frequency independent of CPU frequency when EST is used.
|-
| CR8Legacy
| CR8 in 32-bit mode.
|-
| CX8
| CMPXCHG8B Instruction (Compare and exchange 8 bytes. Also known as F00F, which is an abbreviation of the hexadecimal encoding of an instruction that exhibits a design flaw in the majority of older Intel Pentium CPU's).
|-
| CX16
| CMPXCHG16B Instruction (CMPXCHG16B allows for atomic operations on 128-bit double quadword (or oword) data types. This is useful for high resolution counters that could be updated by multiple processors (or cores). Without CMPXCHG16B the only way to perform such an operation is by using a critical section).
|-
| DE
| Debugging Extensions.
|-
| DS
| Debug Store.
|-
| DS_CPL
| CPL qualified Debug Store (whatever CPL might mean in this context).
|-
| DTS
| Could mean either Debug Trace Store or Digital Thermal Sensor, depending on source.
|-
| EIST/EST
| Enhanced Intel SpeedStep Technology.
|-
| EPT
| Extended Page Tables (Intel, similar to NPT on AMD).
|-
| FID
| Frequency IDentifier.
|-
| FPU
| x87 Floating Point Unit built into the CPU. This is where most mathematically intense calculations take place. Used to be a separate chip on the 80486SX and earlier (called the 80487 or 80387, etc. 80486DX had FPU built-in as well). All Pentium CPUs and later have this functionality built in.
|-
| FXSR
| FXSAVE/FXRSTOR. (The FXSAVE instruction writes the current state of the x87 FPU, MMX technology, Streaming SIMD Extensions, and Streaming SIMD Extensions 2 data, control, and status registers to the destination operand. The destination is a 512-byte memory location. FXRSTOR will restore the state saves).
|-
| FXSR_OPT
| FXSR optimisations.
|-
| HT
| Hyper-Transport. Note that the same abbreviation might is also used to indicate Hyper-Threading (see below).
|-
| HTT/HT
| Hyper-Threading. An Intel technology that allows quasi-parallel execution of different instructions on a single core. The single core is seen by applications as if it were two (or potentially more) cores. However, two true CPU cores are almost always faster than a single core with HyperThreading. This flag indicates support in the CPU when checking the flags in /proc/cpuinfo on Linux systems.
|-
| HVM
| Hardware support for virtual machines (Xen abbreviation for AMD SVM / Intel VMX).
|-
| LAHF_LM
| Load Flags into AH Register, Long Mode.
|-
| LM
| Long Mode (64bit Extensions, AMD's AMD64 or Intel's EM64T).
|-
| MCA
| Machine Check Architecture.
|-
| MCE
| Machine Check Exception.
|-
| MMX
| It is rumoured to stand for MultiMedia eXtension or Multiple Math or Matrix Math eXtension, but officially it is a meaningless acronym trademarked by Intel.
|-
| MMXEXT
| MMX Extensions – an enhanced set of instructions compared to MMX.
|-
| MNI
| Modular Network Interface or Merom New Instruction (see SSSE3).
|-
| MON/MONITOR
| CPU Monitor.
|-
| MSR
| RDMSR and WRMSR Support.
|-
| MTRR
| Memory Type Range Register.
|-
| NPT
| Nested Page Tables (AMD, similar to EPT on Intel).
|-
| NX
| No eXecute, a flag that can be set on memory pages to disable execution of code in these pages.
|-
| PAE
| Physical Address Extensions. PAE is the added ability of the IA32 processor to address more than 4 GB of physical memory using Intel's 36bit page addresses instead of the standard 32bit page addresses to access a total of 64gibibytes of RAM. Most AMD chips support PAE as well.

PAE is the second method supported to access memory above 4 GB (PSE36 being the first); this method has been widely implemented. PAE maps up to 64 GB of physical memory into a 32-bit (4 GB) virtual address space using either 4-KB or 2-MB pages. The Page directories and the page tables are extended to 8 byte formats, allowing the extension of the base addresses of page tables and page frames to 24 bits (from 20 bits). This is where the extra four bits are introduced to complete the 36-bit physical address.

Windows supports PAE with 4-KB pages. PAE also supports a mode where 2-MB pages are supported. Many of the UNIX operating systems rely on the 2 MB-page mode. The address translation is done without the use of page tables (the PDE supplies the page frame address directly).
|-
| PAT
| Page Attribute Table.
|-
| PBE
| Pending Break Encoding.
|-
| PGE
| PTE Global Bit.
|-
| PNI
| Prescott New Instruction. This was the codename for SSE3 before it was released on the Intel Prescott processor (which was later added to the Pentium 4 family name).
|-
| PSE
| Page Size Extensions (See PSE36).
|-
| PSE36
| Page Size Extensions 36. IA-32 supports two methods to access memory above 4 GB (32 bits). PSE (Page Size Extension) was the first method, which shipped with the Pentium II. This method offers a compatibility advantage because it kept the PTE (page table entry) size of 4 bytes. However, the only practical implementation of this is through a driver. This approach suffers from significant performance limitations, due to a buffer copy operation necessary for reading and writing above 4 GB. PSE mode is used in the PSE 36 RAM disk usage model.

PSE uses a standard 1K directory and no page tables to extend the page size 4-MB (eliminating one level of indirection for that mode). The Page Directory Entries (PDE) contains 14 bits of address, and when combined with the 22-bit byte index, yields the 36 bits of extended physical address. Both 4-KB and 4-MB pages are simultaneously supported below 4 GB, with the 4-KB pages supported in the standard way.

Note that pages located above 4 GB must use PSE mode (with 4-MB page sizes).
|-
| SEP
| SYSENTER and SYSEXIT.
|-
| SS
| Self-Snoop.
|-
| SSE
| Streaming SIMD Extensions. Developed by Intel for its Pentium III but also implemented by AMD processors from Athlon XP onwards.
|-
| SSE2
| Streaming SIMD Extensions 2 (An additional 144 SIMDs). Introduced by Intel Pentium 4 and on AMD since Athlon 64.
|-
| SSE3
| Streaming SIMD Extensions 3 (An additional 13 instructions). Introduced with “Prescott” revision Intel Pentium 4 processors. AMD introduced SSE3 with the Athlon 64 "Venice" revision.
|-
| SSSE3
| Supplemental Streaming SIMD Extension 3 (SSSE3 contains 16 new discrete instructions over SSE3). Introduced on Intel Core 2 Duo processors. No AMD chip supports SSSE3 yet.
|-
| SSE4
| Streaming SIMD Extentions 4. Introduced with "Nehalem" processor in 2008. Also known as "Nehalem New Instructions" (NNI).
|-
| SSE4_1
| Streaming SIMD Extentions 4.1.
|-
| SSE4_2
| Streaming SIMD Extentions 4.2.
|-
| SVM
| Secure Virtual Machine. (AMD's virtualization extensions to the 64-bit x86 architecture, equivalent to Intel's VMX, both also known as HVM in the Xen hypervisor).
|-
| SYSCALL
| System Call (the mechanism used by an application program to request service from the operating system).
|-
| TM
| Thermal Monitor.
|-
| TM2
| Thermal Monitor 2.
|-
| TNI
| Tejas New Instruction. See SSSE3.
|-
| TPR
| Task Priority Register.
|-
| TPR_SHADOW
| Shadowed Task Priority Registers (for virtualization).
|-
| TS
| Thermal Sensor.
|-
| TSC
| Time Stamp Counter.
|-
| TTP
| Thermal Trip.
|-
| VID
| Voltage IDentifier
|-
| VME
| Virtual-8086 Mode Enhancement.
|-
| VMX
| Intel's equivalent to AMD's SVM.
|-
| VNMI
| Virtual NMI (non-maskable interrupts) (for virtualization).
|-
| VPID
| Virtual Processor ID (for virtualization).
|-
| XTPR
| TPR register chipset update control messenger. Part of the APIC code.
|}

Making a English Wikipedia server

2024-10-10T03:47:08Z

Sam: /* Finish configuring LocalSettings.php */ Removed unneeded lines

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entirely on the English Wikipedia, but should be quite relevant for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preparation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-<date>-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon
* The following extra extensions need to be downloaded, extracted and dropped in the extensions folder:
** [https://www.mediawiki.org/wiki/Extension:MassMessage MassMessage]
** [https://www.mediawiki.org/wiki/Extension:TemplateStyles TemplateStyles]
** [https://www.mediawiki.org/wiki/Extension:JsonConfig JsonConfig]
** [https://www.mediawiki.org/wiki/Extension:MobileFrontend MobileFrontend]

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving database to a different hard drive ===

Due to the sheer size of the database, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a separate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
*** ParserFunctions
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed successfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP time zone - in our case, <code>Europe/London</code>
* Add under <code>$wgGroupPermissions['*']['edit'] = false;</code>:
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'ParserFunctions' );</code>:
$wgPFEnableStringFunctions = true;
* Add under <code>wfLoadExtension( 'Scribunto' );</code>:
$wgScribuntoDefaultEngine = 'luastandalone';
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;
* Add the following block at the end - this allows larger modules to be uploaded without errors:
$wgMaxArticleSize = 4096; # Size in kb
$wgAPIMaxResultSize = 4096000; # Size in b

Go back to the website and check that it is still functional. If you are greeted by a blank page, the most common reason is a missing <code>;</code> at the end of a line - all lines must end with a <code>;</code>.

== Importing the dump ==

Installing Jellyfin

2024-09-10T19:33:45Z

Sam: Created article

Jellyfin is a free and open-source media server and suite of multimedia applications designed to organize, manage, and share digital media files to networked devices.

An RPM package is not provided for openSUSE so Jellyfin must be installed from the Linux manual install tarball. This guide will explain how to do this. This guide is written with the current version of Jellyfin 10.9.11.

== What you need to know ==

You will need to download the following:
* Jellyfin Generic Linux Server package
* <code>jellyfin-ffmpeg</code>tarball

The following packages need installing:
* <code>gcc</code>
* <code>make</code>
* <code>yasm</code>

The following packages need installing from Packman:
* <code>libx264-devel</code> - required
* <code>libx265-devel</code> - optional for H.265/HEVC transcoding
* <code>SVT-AV1-devel</code> - optional for AV1 transcoding

== Installing Jellyfin ==

* Create the directory <code>sudo mkdir /opt/jellyfin</code>
* Move into the directory <code>cd /opt/jellyfin</code>
* Download the latest tarball from the [https://repo.jellyfin.org/?path=/server/linux/latest-stable/amd64 Jellyfin website] - for example, <code>wget https://repo.jellyfin.org/files/server/linux/latest-stable/amd64/jellyfin_10.9.11-amd64.tar.gz</code>
* Unzip the tar archive, <code>sudo tar zxvf jellyfin_10.9.11-amd64.tar.gz</code>
* We need to create the script to run Jellyfin and run it as a service. Open <code>sudo nano jellyfin.sh</code> and add the following to the script file:
#!/bin/bash
JELLYFINDIR="/opt/jellyfin"
FFMPEGDIR="/usr/share/jellyfin-ffmpeg/bin"

$JELLYFINDIR/jellyfin/jellyfin \
-d $JELLYFINDIR/data \
-C $JELLYFINDIR/cache \
-c $JELLYFINDIR/config \
-l $JELLYFINDIR/log \
--ffmpeg $FFMPEGDIR/ffmpeg
* Press Ctrl+W to save the file
* Run <code>sudo chmod +x jellyfin.sh</code> to make the script executable
* Move back into the Jellyfin directory and initially run the Jellyfin script created earlier <code>./jellyfin.sh</code>
* Once it has started, close the script by pressing Ctrl+C
* Move up a directory <code>cd ..</code>. Take ownership of the file under the user you are running <code>sudo chown -R <username>:users jellyfin</code>. '''Note:''' <code><username></code> needs changing to whatever your username is

=== Install service script ===

This will guide you on how to create a script to start Jellyfin as a service on startup.

* Move to <code>cd /etc/systemd/system</code>
* We need to create the script to run Jellyfin as a service. Open <code>sudo nano jellyfin.service</code> and add the following to the script file:
[Unit]
Description=Jellyfin
After=network.target

[Service]
Type=simple
User=<username>
Restart=always
ExecStart=/opt/jellyfin/jellyfin.sh

[Install]
WantedBy=multi-user.target

'''Note:''' <code>User=<username></code> should be changed to the same user that took ownership of the Jellyfin folder earlier.
* Press Ctrl+W to save the file
* Correct the permissions of the service file <code>sudo chmod 644 jellyfin.service</code>
* Reload the system daemons to allow the service to load <code>sudo systemctl daemon-reload</code>
* Run the Jellyfin service and check it starts <code>sudo service jellyfin start</code>
* If you'd like Jellyfin to run on startup, run <code>sudo systemctl enable jellyfin.service</code>

== Install <code>jellyfin-ffmpeg</code> ==

openSUSE does not come with an FFMpeg version that includes propriety formats such as H.264 and H.265/HEVC. We need to install <code>jellyfin-ffmpeg</code> which includes these formats and is tailored for hardware encoding for Jellyfin. A few dependencies need installing first.

* We need to add the Packman repository that includes the dependencies we need <code>sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_$releasever/' packman</code>
* Refresh zypper to load the new repositories <code>sudo zypper ref</code>. Accept the keys needed for the repositories.
* Install the base proprietary codecs <code>sudo zypper install --allow-vendor-change --from packman ffmpeg gstreamer-plugins-{good,bad,ugly,libav} libavcodec vlc-codecs</code>
* Install the dependency packages depending on what you need: <code>sudo zypper in libx264-devel libx265-devel SVT-AV1-devel</code>. Allow any extra dependencies these may require.
* Install the base packages need to compile <code>jellyfin-ffmpeg</code>: <code>sudo zypper in gcc make yasm</code>
* Move to your home downloads folder <code>cd ~/Downloads</code>
* Download the <code>jellyfin-ffmpeg</code> from [https://github.com/jellyfin/jellyfin-ffmpeg/releases GitHub]. Ensure that the version is compatible with the version of Jellyfin you have installed - for example Jellyfin 10.9.11 is compatible with the latest <code>jellyfin-ffmpeg</code> package 6.0.1-8. Download the source tar.gz package with <code>wget https://github.com/jellyfin/jellyfin-ffmpeg/archive/refs/tags/v6.0.1-8.tar.gz</code>.
'''Tip:''' You may need to expand the Assets tab to show the downloadable packages.
* Extract the package with <code>tar zxvf v6.0.1-8.tar.gz</code>
* Move into the folder created <code>cd jellyfin-ffmpeg-6.0.1-8</code>
* Run <code>./configure --prefix=/usr/share/jellyfin-ffmpeg --enable-libx264 --enable-libx265 --enable-libsvtav1 --enable-gpl</code>.
This will configure the package to be installed to <code>/usr/share/jellyfin-ffmeg</code> with H.264, H.265/HEVC and AV1. Due to H.264 and H.265/HEVC being licensed under a GPL license, the whole package will be licensed under GPL which is enabled by the switch. This can be configured as needed by adding/removing switches.
* Run <code>make</code>. This will compile the code and may take a while
* Run <code>make install</code> to install

== Configuring Jellyfin ==

Jellyfin is configured through the web browser. Open a web browser and go to the following address: <code>http://localhost:8096</code>. You should get the first run installer after installation is complete.

MediaWiki:Disclaimers

2024-08-24T13:04:49Z

Sam: Removed disclaimers

MediaWiki:Privacy

2024-08-24T13:04:17Z

Sam: Removed privacy policy

OpenSUSE Leap 15.6 Release Notes

2024-08-23T23:20:05Z

Sam: /* System Upgrade */ Corrected section link

openSUSE Leap is a free and Linux-based operating system for your PC, Laptop or Server. You can surf the Web, manage your e-mails and photos, do office work, play videos or music and have a lot of fun!

'''Publication Date:''' 2024-06-10, '''Version:''' 15.6.20240610.a9f19f4

This is the initial version of the release notes for the forthcoming openSUSE Leap 15.6.

If you upgrade from an older version to this openSUSE Leap release, see previous release notes listed here: https://en.opensuse.org/openSUSE:Release_Notes.

This public beta test is part of the openSUSE project. Information about the project is available at https://www.opensuse.org.

Report all bugs you encounter using this prerelease of openSUSE Leap 15.6 in the openSUSE Bugzilla. For more information, see https://en.opensuse.org/Submitting_Bug_Reports. If you would like to see anything added to the release notes, file a bug report against the component “Release Notes”.

== Installation ==

This section contains installation-related notes. For detailed installation instructions, see the documentation at https://doc.opensuse.org/documentation/leap/startup/html/book-startup/part-basics.html.

=== Using Atomic Updates With the System Role Transactional Server ===

The installer supports the system role ''Transactional Server''. This system role features an update system that applies updates atomically (as a single operation) and makes them easy to revert should that become necessary. These features are based on the package management tools that all other SUSE and openSUSE distributions also rely on. This means that the vast majority of RPM packages that work with other system roles of openSUSE Leap 15.6 also work with the system role ''Transactional Server''.

<div style="background:#C0C0C0;border:1px solid #666666;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Note: Incompatible packages'''

Some packages modify the contents of <code>/var</code> or <code>/srv</code> in their RPM <code>%post</code> scripts. These packages are incompatible. If you find such a package, file a bug report.
</div>

To provide these features, this update system relies on:

* '''Btrfs snapshots.''' Before a system update is started, a new Btrfs snapshot of the root file system is created. Then, all the changes from the update are installed into that Btrfs snapshot. To complete the update, you can then restart the system into the new snapshot.

To revert the update, simply boot from the previous snapshot instead.

* '''A read-only root file system.''' To avoid issues with and data loss because of updates, the root file system must not be written to otherwise. Therefore, the root file system is mounted read-only during normal operation.<br><br>To make this setup work, two additional changes to the file system needed to be made: To allow writing user configuration in <code>/etc</code>, this directory is automatically configured to use OverlayFS. <code>/var</code> is now a separate subvolume which can be written to by processes.

<div style="background:#FDDFA6;border:1px solid #BB7B03;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Important: ''Transactional Server'' Needs At Least 12 GB of Disk Space'''

The system role ''Transactional Server'' needs a disk size of at least 12 GB to accommodate Btrfs snapshots.
</div>
<br>
<div style="background:#FDDFA6;border:1px solid #BB7B03;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Important: YaST Does Not Work Transactional Mode'''

Currently, YaST does not work with transactional updates. This is because YaST performs things immediately and because it cannot edit a read-only filesystem.
</div>

To work with transactional updates, always use the command '''<code>transactional-update</code>''' instead of YaST and Zypper for all software management:

* Update the system: '''<code>transactional-update up</code>'''
* Install a package: '''<code>transactional-update pkg in ''PACKAGE_NAME''</code>'''
* Remove a package: '''<code>transactional-update pkg rm ''PACKAGE_NAME''</code>'''
* To revert the last snapshot, that is the last set of changes to the root file system, make sure your system is booted into the next to last snapshot and run: '''<code>transactional-update rollback</code>'''<br><br>Optionally, add a snapshot ID to the end of the command to rollback to a specific ID.

When using this system role, by default, the system will perform a daily update and reboot between 03:30 am and 05:00 am. Both of these actions are systemd-based and if necessary can be disabled using systemctl:

systemctl disable --now transactional-update.timer rebootmgr.service

For more information about transactional updates, see the openSUSE Kubic blog posts https://kubic.opensuse.org/blog/2018-04-04-transactionalupdates/ and https://kubic.opensuse.org/blog/2018-04-20-transactionalupdates2/.

=== Installing on Hard Disks With Less Than 12 GB of Capacity ===

The installer will only propose a partitioning scheme if the available hard disk size is larger than 12 GB. If you want to set up, for example, very small virtual machines images, use the guided partitioner to tune partitioning parameters manually.

=== UEFI - Unified Extensible Firmware Interface ===

Prior to installing openSUSE on a system that boots using UEFI (Unified Extensible Firmware Interface), you are urgently advised to check for any firmware updates the hardware vendor recommends and, if available, to install such an update. A pre-installation of Windows 8 or later is a strong indication that your system boots using UEFI.

''Background:'' Some UEFI firmware has bugs that cause it to break if too much data gets written to the UEFI storage area. However, there is no clear data of how much is "too much".

openSUSE minimizes the risk by not writing more than the bare minimum required to boot the OS. The minimum means telling the UEFI firmware about the location of the openSUSE boot loader. Upstream Linux kernel features that use the UEFI storage area for storing boot and crash information (<code>pstore</code>) have been disabled by default. Nevertheless, it is recommended to install any firmware updates the hardware vendor recommends.

=== UEFI, GPT and MS-DOS Parititions ===

Together with the EFI/UEFI specification, a new style of partitioning arrived: GPT (GUID Partition Table). This new schema uses globally unique identifiers (128-bit values displayed in 32 hexadecimal digits) to identify devices and partition types.

Additionally, the UEFI specification also allows legacy MBR (MS-DOS) partitions. The Linux boot loaders (ELILO or GRUB 2) try to automatically generate a GUID for those legacy partitions, and write them to the firmware. Such a GUID can change frequently, causing a rewrite in the firmware. A rewrite consists of two different operations: Removing the old entry and creating a new entry that replaces the first one.

Modern firmware has a garbage collector that collects deleted entries and frees the memory reserved for old entries. A problem arises when faulty firmware does not collect and free those entries. This can result in a non-bootable system.

To work around this problem, convert the legacy MBR partition to GPT.

== System Upgrade ==

This section lists notes related to upgrading the system. For supported scenarios and detailed upgrade instructions, see the documentation at:

* https://en.opensuse.org/SDB:System_upgrade
* https://doc.opensuse.org/documentation/leap/startup/html/book-startup/cha-update-osuse.html

Make sure to also review the following sections of this documentation:

* Section "[[#Packaging Changes|Packaging Changes]]"
* Section "[[#Usage of 4096 bit RSA RPM and repository signing key|Usage of 4096 bit RSA RPM and repository signing key]]"

== Packaging Changes ==

=== Important changes in updated packages ===

Package python-podman is now based on the project [https://github.com/containers/podman-py podman-py] was [https://github.com/containers/python-podman python-podman].

=== Deprecated Packages ===

Deprecated packages are still shipped as part of the distribution but are scheduled to be removed the next version of openSUSE Leap. These packages exist to aid migration, but their use is discouraged and they may not receive updates.

To check whether installed packages are no longer maintained, make sure that the <code>lifecycle-data-openSUSE</code> package is installed, then use the command:

zypper lifecycle

=== Removed Packages ===

Removed packages are not shipped as part of the distribution anymore.

The following packages were all superseded by [https://en.opensuse.org/SDB:NVIDIA_SUSE_Prime NVIDIA SUSE Prime]. Also see Section "[[#Removal of Bumblebee packages|Removal of Bumblebee packages]]"

* <code>bbswitch</code>
* <code>bumblebee</code>
* <code>bumblebee-status</code>
* <code>primus</code>

The following python packages were all removed from openSUSE Leap 15.6 as they are unmaintained and no longer part of openSUSE Factory.

* <code>python-pytest-faulthandler</code>
* <code>python-pytest-flake8dir</code>
* <code>python-pytest-ordering</code>
* <code>python-pytest-</code>
* <code>pythonpath</code>
* <code>python-pytest-random-order</code>
* <code>python-pytest-repeat</code>
* <code>python-pytest-reqs</code>
* <code>python-pytest-travis-fold</code>
* <code>python-IMDbPY</code>
* <code>python-Keras-Applications</code>
* <code>python-Ming</code>
* <code>python-PasteScript</code>
* <code>python-PyPrint</code>
* <code>python-Pykka</code>
* <code>python-Qt.py</code>
* <code>python-Quandl</code>
* <code>python-Theano</code>
* <code>python-abclient</code>
* <code>python-jupyter-nbutils</code>
* <code>python-jupyter_calysto</code>
* <code>python-jupyter_contrib_core</code>
* <code>python-jupyter_full_width</code>
* <code>python-jupyter_highlight_selected_word</code>
* <code>python-jupyter_imatlab_kernel</code>
* <code>python-jupyter_jgraph</code>
* <code>python-jupyter_jupyterlab_launcher</code>
* <code>python-jupyter_latex_envs</code>
* <code>python-jupyter_nbpresent</code>
* <code>python-jupyter_nbsmoke</code>
* <code>python-jupyter_sphinx</code>
* <code>python-jupyter_themer</code>
* <code>python-jupyter_vega</code>
* <code>python-jupyter_watermark</code>
* <code>python-nbindex-jupyter</code>
* <code>python-dephell-archive</code>
* <code>python-dephell-argparse</code>
* <code>python-dephell-discover</code>
* <code>python-dephell-licenses</code>
* <code>python-dephell-links</code>
* <code>python-dephell-setuptools</code>
* <code>python-dephell-shells</code>
* <code>python-demjson</code>
* <code>python-discover</code>
* <code>python-django-babel</code>
* <code>python-djvulibre</code>
* <code>python-dnsdiag</code>
* <code>python-efilter</code>
* <code>python-enum-compat</code>
* <code>python-featureflow</code>
* <code>python-flake8-future-import</code>
* <code>python-flask-peewee</code>
* <code>python-flask-restplus</code>
* <code>python-pep517</code>
* <code>python-piston-mini-client</code>
* <code>python-pomegranate</code>
* <code>python-proboscis</code>
* <code>python-pyIOSXR</code>
* <code>python-pyblake2</code>
* <code>python-pyfg</code>
* <code>python-pygeos</code>
* <code>python-pympv</code>
* <code>python-python-fileinspector</code>
* <code>python-python-jsonrpc-server</code>
* <code>python-socketIO-client-nexus</code>
* <code>python-sphinxcontrib-actdiag</code>
* <code>python-spyder-line-profiler</code>
* <code>python-spyder-memory-profiler</code>
* <code>python-spyder-unittest</code>
* <code>python-sqlsoup</code>
* <code>python-test-server</code>
* <code>python-img2pdf</code>
* <code>python-jenkins-job-builder</code>
* <code>python-jgraph</code>
* <code>python-jsonextended</code>
* <code>python-jsonlib-python3</code>
* <code>python-jsonpath-rw-ext</code>
* <code>python-jupytext</code>
* <code>python-keepalive</code>
* <code>python-keyczar</code>
* <code>python-language-check</code>
* <code>python-logilab-astng</code>
* <code>python-lws</code>
* <code>python-lzmaffi</code>
* <code>python-missingno</code>
* <code>python-mockldap</code>
* <code>python-moksha-common</code>
* <code>python-moviepy</code>
* <code>python-murano-pkg-check</code>
* <code>python-uncompyle6</code>
* <code>python-whois_similarity_distance</code>
* <code>python-nose-cover3</code>
* <code>python-nose-random</code>
* <code>python-openstack.nose_plugin</code>
* <code>python-nagiosplugin</code>
* <code>python-nbsphinx-link</code>
* <code>python-os-api-ref</code>
* <code>python-oslo.db</code>
* <code>python-pampy</code>
* <code>python-pass_</code>
* <code>python_keyring</code>
* <code>python-pdfkit</code>
* <code>python-qgrid</code>
* <code>python-raet</code>
* <code>python-ravello-sdk</code>
* <code>python-requests-html</code>
* <code>python-ruamel.yaml.cmd</code>
* <code>python-rustcfg</code>
* <code>python-serpy</code>
* <code>python-shouldbe</code>
* <code>python-sigal</code>
* <code>python-slumber</code>
* <code>python-torch</code>
* <code>python-tox-travis</code>
* <code>python-trello</code>
* <code>python-twodict</code>

== Drivers and Hardware ==

=== Removal of Bumblebee packages ===

Packages maintained as part of [https://build.opensuse.org/project/show/X11:Bumblebee X11:Bumblebee] project were succeeded by [https://en.opensuse.org/SDB:NVIDIA_SUSE_Prime NVIDIA SUSE Prime]. Bumblebee packages will no longer be part of the standard distribution. See details in [https://code.opensuse.org/leap/features/issue/142 the drop feature request tracker].

=== Secure Boot: Third-Party Drivers Need to Be Properly Signed ===

Starting with openSUSE Leap 15.2, kernel module signature check for third-party drivers (<code>CONFIG_MODULE_SIG=y</code>) is now enabled. This is an important security measure to avoid untrusted code running in the kernel.

This may prevent third-party kernel modules from being loaded if UEFI Secure Boot is enabled. Kernel Module Packages (KMPs) from the official openSUSE repositories are not affected, because the modules they contain are signed with the openSUSE key. The signature check has the following behaviour:

* Kernel modules that are unsigned or signed with a key that is either known as untrusted or cannot be verified against the system's trusted key data base will be blocked.

It is possible to generate a custom certificate, enroll it into the system's Machine Owner Key (MOK) data base, and sign locally compiled kernel modules with this certificate's key. Modules signed in this manner will neither be blocked nor cause warnings. See https://en.opensuse.org/openSUSE:UEFI.

Since this also affects NVIDIA graphics drivers, we addressed this in our official packages for openSUSE. However, you need to manually enroll a new MOK key after installation to make the new packages work. For instructions how to install the drivers and enroll the MOK key, see https://en.opensuse.org/SDB:NVIDIA_drivers#Secureboot.

=== Network install image hangs on boot on Raspberry Pi ===

Booting the network install image from USB stick on Raspberry Pi 4 hangs on boot. To resolve this issue, add the <code>console=tty</code> boot parameter. See details in the known issues section of our [https://en.opensuse.org/HCL:Raspberry_Pi4#Boot_from_USB_in_Net_install_image_of_Leap_15.4_hangs_on_boot Raspberry Pi 4 Hardware Compatibility List].

== Desktop ==

This section lists desktop issues and changes in openSUSE Leap 15.6.

=== KDE 4 and Qt 4 removal ===

KDE 4 packages will not be part of openSUSE Leap 15.4. Please update your system to Plasma 5 and Qt 5. Some of Qt 4 packages might still remain for compatibility reasons. https://bugzilla.opensuse.org/show_bug.cgi?id=1179613.

=== <code>noveau</code> disabled for NVIDIA Turing and Ampere GPUs/openGPU recommendation ===

The <code>nouveau</code> driver is still considered experimental for Nvidia Turing and Ampere GPUs. Therefore it has been disabled by default on systems with these GPUs.

Instead of using the nouveau driver we recommend using Nvidia's new openGPU driver. Install this driver by installing these following packages:

* nvidia-open-driver-G06-signed-kmp-default
* kernel-firmware-nvidia-gsp-G06

Then uncomment the <code>options nvidia</code> line in the <code>/etc/modprobe.d/50-nvidia-default.conf</code> file so that it looks like the following afterwards:

### Enable support on *all* Turing/Ampere GPUs: Alpha Quality!
options nvidia NVreg_OpenRmEnableUnsupportedGpus=1

If you prefer using <code>nouveau</code> driver anyway, add <code>nouveau.force_probe=1</code> to your kernel boot parameters, and do not install the above openGPU package.

=== Starting <code>ibus</code> automatically under KDE Plasma ===

<code>ibus</code> does not start automatically under KDE Plasma. This can be fixed by adding the appropriate command to the autostart section. To do that, go to System Settings, Startup and Shutdown, Autostart and there click on the Add… button, and then click on Add Application…. In the opened dialog window type <code>ibus-daemon -x</code> into the text box and click OK. For more information see https://bugzilla.suse.com/show_bug.cgi?id=1211977.

== General ==

=== <code>iotop</code> support ===

'''<code>iotop</code>''' does not display values for SWAPIN and IO %.

Since Linux kernel 5.14, either kernel boot parameter <code>delayacct</code> needs to be specified or <code>kernel.task_delayacct</code> sysctl needs to be enabled.

== Security ==

This section lists changes to security features in openSUSE Leap 15.6

=== Usage of 4096 bit RSA RPM and repository signing key ===

We switched the RPM and repository signing key of openSUSE Leap 15.5 from 2048 bit RSA to a 4096 bit RSA key. This key was previously introduced to openSUSE Leap 15.4 users in a maintenance update. Users upgrading from older releases will need to import the new key manually as described in https://en.opensuse.org/SDB:System_upgrade#0._New_4096_bit_RSA_signing_key.

=== Cockpit root login is disabled by default ===

Cockpit is newly part of openSUSE Leap 15.6. However, similarly to sshd, the password-based login for root is disabled by default. Users need to manually edit <code>/etc/cockpit/disallowed-users</code> and restart <code>cockpit.socket</code> as described in https://news.opensuse.org/2024/04/29/try-cockpit-in-leap-rc/ to allow root login.

== More Information and Feedback ==

* Read the <code>README</code> documents on the medium.
* View a detailed changelog information about a particular package from its RPM:<br><code>rpm --changelog -qp FILENAME.rpm</code>
* Replace ''<code>FILENAME</code>'' with the name of the RPM.
* Check the <code>ChangeLog</code> file in the top level of the medium for a chronological log of all changes made to the updated packages.
* Find more information in the <code>docu</code> directory on the medium.
* For additional or updated documentation, see https://doc.opensuse.org/ .
* For the latest product news, from openSUSE, visit https://www.opensuse.org.

Copyright © 2024 SUSE LLC

OpenSUSE Leap 15.6 Release Notes

2024-08-23T23:19:16Z

Sam: /* Removed Packages */ Corrected section link

openSUSE Leap is a free and Linux-based operating system for your PC, Laptop or Server. You can surf the Web, manage your e-mails and photos, do office work, play videos or music and have a lot of fun!

'''Publication Date:''' 2024-06-10, '''Version:''' 15.6.20240610.a9f19f4

This is the initial version of the release notes for the forthcoming openSUSE Leap 15.6.

If you upgrade from an older version to this openSUSE Leap release, see previous release notes listed here: https://en.opensuse.org/openSUSE:Release_Notes.

This public beta test is part of the openSUSE project. Information about the project is available at https://www.opensuse.org.

Report all bugs you encounter using this prerelease of openSUSE Leap 15.6 in the openSUSE Bugzilla. For more information, see https://en.opensuse.org/Submitting_Bug_Reports. If you would like to see anything added to the release notes, file a bug report against the component “Release Notes”.

== Installation ==

This section contains installation-related notes. For detailed installation instructions, see the documentation at https://doc.opensuse.org/documentation/leap/startup/html/book-startup/part-basics.html.

=== Using Atomic Updates With the System Role Transactional Server ===

The installer supports the system role ''Transactional Server''. This system role features an update system that applies updates atomically (as a single operation) and makes them easy to revert should that become necessary. These features are based on the package management tools that all other SUSE and openSUSE distributions also rely on. This means that the vast majority of RPM packages that work with other system roles of openSUSE Leap 15.6 also work with the system role ''Transactional Server''.

<div style="background:#C0C0C0;border:1px solid #666666;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Note: Incompatible packages'''

Some packages modify the contents of <code>/var</code> or <code>/srv</code> in their RPM <code>%post</code> scripts. These packages are incompatible. If you find such a package, file a bug report.
</div>

To provide these features, this update system relies on:

* '''Btrfs snapshots.''' Before a system update is started, a new Btrfs snapshot of the root file system is created. Then, all the changes from the update are installed into that Btrfs snapshot. To complete the update, you can then restart the system into the new snapshot.

To revert the update, simply boot from the previous snapshot instead.

* '''A read-only root file system.''' To avoid issues with and data loss because of updates, the root file system must not be written to otherwise. Therefore, the root file system is mounted read-only during normal operation.<br><br>To make this setup work, two additional changes to the file system needed to be made: To allow writing user configuration in <code>/etc</code>, this directory is automatically configured to use OverlayFS. <code>/var</code> is now a separate subvolume which can be written to by processes.

<div style="background:#FDDFA6;border:1px solid #BB7B03;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Important: ''Transactional Server'' Needs At Least 12 GB of Disk Space'''

The system role ''Transactional Server'' needs a disk size of at least 12 GB to accommodate Btrfs snapshots.
</div>
<br>
<div style="background:#FDDFA6;border:1px solid #BB7B03;padding-left:5px;padding-right:5px;padding-bottom:5px;padding-top:5px;">
'''Important: YaST Does Not Work Transactional Mode'''

Currently, YaST does not work with transactional updates. This is because YaST performs things immediately and because it cannot edit a read-only filesystem.
</div>

To work with transactional updates, always use the command '''<code>transactional-update</code>''' instead of YaST and Zypper for all software management:

* Update the system: '''<code>transactional-update up</code>'''
* Install a package: '''<code>transactional-update pkg in ''PACKAGE_NAME''</code>'''
* Remove a package: '''<code>transactional-update pkg rm ''PACKAGE_NAME''</code>'''
* To revert the last snapshot, that is the last set of changes to the root file system, make sure your system is booted into the next to last snapshot and run: '''<code>transactional-update rollback</code>'''<br><br>Optionally, add a snapshot ID to the end of the command to rollback to a specific ID.

When using this system role, by default, the system will perform a daily update and reboot between 03:30 am and 05:00 am. Both of these actions are systemd-based and if necessary can be disabled using systemctl:

systemctl disable --now transactional-update.timer rebootmgr.service

For more information about transactional updates, see the openSUSE Kubic blog posts https://kubic.opensuse.org/blog/2018-04-04-transactionalupdates/ and https://kubic.opensuse.org/blog/2018-04-20-transactionalupdates2/.

=== Installing on Hard Disks With Less Than 12 GB of Capacity ===

The installer will only propose a partitioning scheme if the available hard disk size is larger than 12 GB. If you want to set up, for example, very small virtual machines images, use the guided partitioner to tune partitioning parameters manually.

=== UEFI - Unified Extensible Firmware Interface ===

Prior to installing openSUSE on a system that boots using UEFI (Unified Extensible Firmware Interface), you are urgently advised to check for any firmware updates the hardware vendor recommends and, if available, to install such an update. A pre-installation of Windows 8 or later is a strong indication that your system boots using UEFI.

''Background:'' Some UEFI firmware has bugs that cause it to break if too much data gets written to the UEFI storage area. However, there is no clear data of how much is "too much".

openSUSE minimizes the risk by not writing more than the bare minimum required to boot the OS. The minimum means telling the UEFI firmware about the location of the openSUSE boot loader. Upstream Linux kernel features that use the UEFI storage area for storing boot and crash information (<code>pstore</code>) have been disabled by default. Nevertheless, it is recommended to install any firmware updates the hardware vendor recommends.

=== UEFI, GPT and MS-DOS Parititions ===

Together with the EFI/UEFI specification, a new style of partitioning arrived: GPT (GUID Partition Table). This new schema uses globally unique identifiers (128-bit values displayed in 32 hexadecimal digits) to identify devices and partition types.

Additionally, the UEFI specification also allows legacy MBR (MS-DOS) partitions. The Linux boot loaders (ELILO or GRUB 2) try to automatically generate a GUID for those legacy partitions, and write them to the firmware. Such a GUID can change frequently, causing a rewrite in the firmware. A rewrite consists of two different operations: Removing the old entry and creating a new entry that replaces the first one.

Modern firmware has a garbage collector that collects deleted entries and frees the memory reserved for old entries. A problem arises when faulty firmware does not collect and free those entries. This can result in a non-bootable system.

To work around this problem, convert the legacy MBR partition to GPT.

== System Upgrade ==

This section lists notes related to upgrading the system. For supported scenarios and detailed upgrade instructions, see the documentation at:

* https://en.opensuse.org/SDB:System_upgrade
* https://doc.opensuse.org/documentation/leap/startup/html/book-startup/cha-update-osuse.html

Make sure to also review the following sections of this documentation:

* Section "[[#Packaging Changes]]"
* Section "[[#Usage of 4096 bit RSA RPM and repository signing key]]"

== Packaging Changes ==

=== Important changes in updated packages ===

Package python-podman is now based on the project [https://github.com/containers/podman-py podman-py] was [https://github.com/containers/python-podman python-podman].

=== Deprecated Packages ===

Deprecated packages are still shipped as part of the distribution but are scheduled to be removed the next version of openSUSE Leap. These packages exist to aid migration, but their use is discouraged and they may not receive updates.

To check whether installed packages are no longer maintained, make sure that the <code>lifecycle-data-openSUSE</code> package is installed, then use the command:

zypper lifecycle

=== Removed Packages ===

Removed packages are not shipped as part of the distribution anymore.

The following packages were all superseded by [https://en.opensuse.org/SDB:NVIDIA_SUSE_Prime NVIDIA SUSE Prime]. Also see Section "[[#Removal of Bumblebee packages|Removal of Bumblebee packages]]"

* <code>bbswitch</code>
* <code>bumblebee</code>
* <code>bumblebee-status</code>
* <code>primus</code>

The following python packages were all removed from openSUSE Leap 15.6 as they are unmaintained and no longer part of openSUSE Factory.

* <code>python-pytest-faulthandler</code>
* <code>python-pytest-flake8dir</code>
* <code>python-pytest-ordering</code>
* <code>python-pytest-</code>
* <code>pythonpath</code>
* <code>python-pytest-random-order</code>
* <code>python-pytest-repeat</code>
* <code>python-pytest-reqs</code>
* <code>python-pytest-travis-fold</code>
* <code>python-IMDbPY</code>
* <code>python-Keras-Applications</code>
* <code>python-Ming</code>
* <code>python-PasteScript</code>
* <code>python-PyPrint</code>
* <code>python-Pykka</code>
* <code>python-Qt.py</code>
* <code>python-Quandl</code>
* <code>python-Theano</code>
* <code>python-abclient</code>
* <code>python-jupyter-nbutils</code>
* <code>python-jupyter_calysto</code>
* <code>python-jupyter_contrib_core</code>
* <code>python-jupyter_full_width</code>
* <code>python-jupyter_highlight_selected_word</code>
* <code>python-jupyter_imatlab_kernel</code>
* <code>python-jupyter_jgraph</code>
* <code>python-jupyter_jupyterlab_launcher</code>
* <code>python-jupyter_latex_envs</code>
* <code>python-jupyter_nbpresent</code>
* <code>python-jupyter_nbsmoke</code>
* <code>python-jupyter_sphinx</code>
* <code>python-jupyter_themer</code>
* <code>python-jupyter_vega</code>
* <code>python-jupyter_watermark</code>
* <code>python-nbindex-jupyter</code>
* <code>python-dephell-archive</code>
* <code>python-dephell-argparse</code>
* <code>python-dephell-discover</code>
* <code>python-dephell-licenses</code>
* <code>python-dephell-links</code>
* <code>python-dephell-setuptools</code>
* <code>python-dephell-shells</code>
* <code>python-demjson</code>
* <code>python-discover</code>
* <code>python-django-babel</code>
* <code>python-djvulibre</code>
* <code>python-dnsdiag</code>
* <code>python-efilter</code>
* <code>python-enum-compat</code>
* <code>python-featureflow</code>
* <code>python-flake8-future-import</code>
* <code>python-flask-peewee</code>
* <code>python-flask-restplus</code>
* <code>python-pep517</code>
* <code>python-piston-mini-client</code>
* <code>python-pomegranate</code>
* <code>python-proboscis</code>
* <code>python-pyIOSXR</code>
* <code>python-pyblake2</code>
* <code>python-pyfg</code>
* <code>python-pygeos</code>
* <code>python-pympv</code>
* <code>python-python-fileinspector</code>
* <code>python-python-jsonrpc-server</code>
* <code>python-socketIO-client-nexus</code>
* <code>python-sphinxcontrib-actdiag</code>
* <code>python-spyder-line-profiler</code>
* <code>python-spyder-memory-profiler</code>
* <code>python-spyder-unittest</code>
* <code>python-sqlsoup</code>
* <code>python-test-server</code>
* <code>python-img2pdf</code>
* <code>python-jenkins-job-builder</code>
* <code>python-jgraph</code>
* <code>python-jsonextended</code>
* <code>python-jsonlib-python3</code>
* <code>python-jsonpath-rw-ext</code>
* <code>python-jupytext</code>
* <code>python-keepalive</code>
* <code>python-keyczar</code>
* <code>python-language-check</code>
* <code>python-logilab-astng</code>
* <code>python-lws</code>
* <code>python-lzmaffi</code>
* <code>python-missingno</code>
* <code>python-mockldap</code>
* <code>python-moksha-common</code>
* <code>python-moviepy</code>
* <code>python-murano-pkg-check</code>
* <code>python-uncompyle6</code>
* <code>python-whois_similarity_distance</code>
* <code>python-nose-cover3</code>
* <code>python-nose-random</code>
* <code>python-openstack.nose_plugin</code>
* <code>python-nagiosplugin</code>
* <code>python-nbsphinx-link</code>
* <code>python-os-api-ref</code>
* <code>python-oslo.db</code>
* <code>python-pampy</code>
* <code>python-pass_</code>
* <code>python_keyring</code>
* <code>python-pdfkit</code>
* <code>python-qgrid</code>
* <code>python-raet</code>
* <code>python-ravello-sdk</code>
* <code>python-requests-html</code>
* <code>python-ruamel.yaml.cmd</code>
* <code>python-rustcfg</code>
* <code>python-serpy</code>
* <code>python-shouldbe</code>
* <code>python-sigal</code>
* <code>python-slumber</code>
* <code>python-torch</code>
* <code>python-tox-travis</code>
* <code>python-trello</code>
* <code>python-twodict</code>

== Drivers and Hardware ==

=== Removal of Bumblebee packages ===

Packages maintained as part of [https://build.opensuse.org/project/show/X11:Bumblebee X11:Bumblebee] project were succeeded by [https://en.opensuse.org/SDB:NVIDIA_SUSE_Prime NVIDIA SUSE Prime]. Bumblebee packages will no longer be part of the standard distribution. See details in [https://code.opensuse.org/leap/features/issue/142 the drop feature request tracker].

=== Secure Boot: Third-Party Drivers Need to Be Properly Signed ===

Starting with openSUSE Leap 15.2, kernel module signature check for third-party drivers (<code>CONFIG_MODULE_SIG=y</code>) is now enabled. This is an important security measure to avoid untrusted code running in the kernel.

This may prevent third-party kernel modules from being loaded if UEFI Secure Boot is enabled. Kernel Module Packages (KMPs) from the official openSUSE repositories are not affected, because the modules they contain are signed with the openSUSE key. The signature check has the following behaviour:

* Kernel modules that are unsigned or signed with a key that is either known as untrusted or cannot be verified against the system's trusted key data base will be blocked.

It is possible to generate a custom certificate, enroll it into the system's Machine Owner Key (MOK) data base, and sign locally compiled kernel modules with this certificate's key. Modules signed in this manner will neither be blocked nor cause warnings. See https://en.opensuse.org/openSUSE:UEFI.

Since this also affects NVIDIA graphics drivers, we addressed this in our official packages for openSUSE. However, you need to manually enroll a new MOK key after installation to make the new packages work. For instructions how to install the drivers and enroll the MOK key, see https://en.opensuse.org/SDB:NVIDIA_drivers#Secureboot.

=== Network install image hangs on boot on Raspberry Pi ===

Booting the network install image from USB stick on Raspberry Pi 4 hangs on boot. To resolve this issue, add the <code>console=tty</code> boot parameter. See details in the known issues section of our [https://en.opensuse.org/HCL:Raspberry_Pi4#Boot_from_USB_in_Net_install_image_of_Leap_15.4_hangs_on_boot Raspberry Pi 4 Hardware Compatibility List].

== Desktop ==

This section lists desktop issues and changes in openSUSE Leap 15.6.

=== KDE 4 and Qt 4 removal ===

KDE 4 packages will not be part of openSUSE Leap 15.4. Please update your system to Plasma 5 and Qt 5. Some of Qt 4 packages might still remain for compatibility reasons. https://bugzilla.opensuse.org/show_bug.cgi?id=1179613.

=== <code>noveau</code> disabled for NVIDIA Turing and Ampere GPUs/openGPU recommendation ===

The <code>nouveau</code> driver is still considered experimental for Nvidia Turing and Ampere GPUs. Therefore it has been disabled by default on systems with these GPUs.

Instead of using the nouveau driver we recommend using Nvidia's new openGPU driver. Install this driver by installing these following packages:

* nvidia-open-driver-G06-signed-kmp-default
* kernel-firmware-nvidia-gsp-G06

Then uncomment the <code>options nvidia</code> line in the <code>/etc/modprobe.d/50-nvidia-default.conf</code> file so that it looks like the following afterwards:

### Enable support on *all* Turing/Ampere GPUs: Alpha Quality!
options nvidia NVreg_OpenRmEnableUnsupportedGpus=1

If you prefer using <code>nouveau</code> driver anyway, add <code>nouveau.force_probe=1</code> to your kernel boot parameters, and do not install the above openGPU package.

=== Starting <code>ibus</code> automatically under KDE Plasma ===

<code>ibus</code> does not start automatically under KDE Plasma. This can be fixed by adding the appropriate command to the autostart section. To do that, go to System Settings, Startup and Shutdown, Autostart and there click on the Add… button, and then click on Add Application…. In the opened dialog window type <code>ibus-daemon -x</code> into the text box and click OK. For more information see https://bugzilla.suse.com/show_bug.cgi?id=1211977.

== General ==

=== <code>iotop</code> support ===

'''<code>iotop</code>''' does not display values for SWAPIN and IO %.

Since Linux kernel 5.14, either kernel boot parameter <code>delayacct</code> needs to be specified or <code>kernel.task_delayacct</code> sysctl needs to be enabled.

== Security ==

This section lists changes to security features in openSUSE Leap 15.6

=== Usage of 4096 bit RSA RPM and repository signing key ===

We switched the RPM and repository signing key of openSUSE Leap 15.5 from 2048 bit RSA to a 4096 bit RSA key. This key was previously introduced to openSUSE Leap 15.4 users in a maintenance update. Users upgrading from older releases will need to import the new key manually as described in https://en.opensuse.org/SDB:System_upgrade#0._New_4096_bit_RSA_signing_key.

=== Cockpit root login is disabled by default ===

Cockpit is newly part of openSUSE Leap 15.6. However, similarly to sshd, the password-based login for root is disabled by default. Users need to manually edit <code>/etc/cockpit/disallowed-users</code> and restart <code>cockpit.socket</code> as described in https://news.opensuse.org/2024/04/29/try-cockpit-in-leap-rc/ to allow root login.

== More Information and Feedback ==

* Read the <code>README</code> documents on the medium.
* View a detailed changelog information about a particular package from its RPM:<br><code>rpm --changelog -qp FILENAME.rpm</code>
* Replace ''<code>FILENAME</code>'' with the name of the RPM.
* Check the <code>ChangeLog</code> file in the top level of the medium for a chronological log of all changes made to the updated packages.
* Find more information in the <code>docu</code> directory on the medium.
* For additional or updated documentation, see https://doc.opensuse.org/ .
* For the latest product news, from openSUSE, visit https://www.opensuse.org.

Copyright © 2024 SUSE LLC

FreePBX Distribution

2024-08-23T23:14:37Z

Sam: Sam moved page FreePBX Distribution to Archive:FreePBX Distribution: Archiving page

#REDIRECT [[Archive:FreePBX Distribution]]

Archive:FreePBX Distribution

2024-08-23T23:14:37Z

Sam: Sam moved page FreePBX Distribution to Archive:FreePBX Distribution: Archiving page

FreePBX Distribution is a fully fledged VoIP server allowing complete customisation to your needs and works with most setups. It is an appliance, with a complete Linux setup and web manager to allow easy administration.

We have implemented FreePBX 16 and Asterisk 20. This is the latest version of Asterisk and is a LTS release so will be supported well into the future with fixes (slated to be supported until 2027). This is a complete distribution and so needs to be installed on its own machine/virtual machine. We will be setting this up on a separate virtual machine rather than the main server.

We will be configuring this system to work with the Mitel 5360 IP Phone and the Mitel 5624 VoWiFi phone so some settings are specific to the 53xx models of this phone. We will also be using Twilio as a SIP trunk so some settings are specific for this.

== Prerequisites ==

* Download the latest FreePBX ISO image. This is currently FreePBX 15 available [https://downloads.freepbxdistro.org/ISO/SNG7-PBX-64bit-2104-1.iso here directly] or at [https://www.freepbx.org/downloads/ this website]. Please do not be phased as at the moment, we will be upgrading to FreePBX 16 once FreePBX 15 is installed.
* This will need burning to a DVD or writing to a USB stick. We use a USB stick and Rufus under windows to write it to a USB stick (use DD mode). This guide will cover the USB method but the CD method is very similar.

== Booting the installation system ==
# Insert the USB stick or DVD into the computer.
# Power on the machine.
# Press the key to bring up the boot device menu if needed.
# Select the USB stick or DVD that is inserted.
# When the boot menu appears, select 'FreePBX 15 Advanced Installation'.
# Next, select 'Advanced Installation with Normal Video'.
# Next, select 'Advanced Install with Asterisk 17 via Standard Video'. Asterisk 17 is the latest available to install from the media but we will upgrade it later. The system will now boot to the Linux installer.

== Configuring the FreePBX installation ==

We will be using a dedicated computer with an empty hard drive. This will be a custom installation so that we can configure the system before it is installed. This guide will show you all the main options that need to be changed - there are other options if you wish to customise the installation but this is what I will be using to install the system.

=== Setting the date, time and time zone ===

# Click '''DATE & TIME''' to select the correct time zone and set the date & time.
# In the 'Region:' box, type or select 'Europe'.
# In the 'City:' box, change 'Amsterdam' by typing of selecting 'London'.
# If you are already connected to a network, ensure that the 'Network Time' switch is 'On'. This is important as this server will be used to set the times on the phones and needs accurate time to function correctly.
# We will configure the time servers to use ones closer to us in the UK. Click the cog icon next to the 'On' switch.
# We will change the CentOS NTP servers to Google servers. For example, double click on the first address and change <code>0.centos.pool.ntp.org</code> to <code>time1.google.com</code>. Do this for servers 0-3 and <code>time1-4</code>.
# We will add the main server IP address as a source too. This is typed in the top box and then click '+'.
# Click 'OK'.
# Click 'Done'.

=== Setting the keyboard layout ===

# Click '''KEYBOARD'''.
# Click the '+' button to add a new keyboard layout. We must add the new keyboard layout before removing the one we don't want.
# Type 'UK' in the search box.
# Click 'English (UK)'.
# Click 'Add'.
# Select 'English (US)' from the list.
# Click the '-' button to remove this layout.
# You may test the layout in the box on the right. I usually check that the '£' and '#' symbols come up when I press these keys.
# Click 'Done'.

=== Setting language support ===

# Click '''LANGUAGE SUPPORT'''.
# Tick 'English (United Kingdom).
#* Unfortunately, we cannot deselect 'English (United States)'.
# Click 'Done'.

=== Setting the hard drive partitioning ===

As this is a new install, we will be configuring FreePBX to use the whole drive. We would like to use the BtrFS file system so this is slightly different to usual.

# Click '''INSTALLATION DESTINATION'''.
# Check that the hard drive we want to use has a tick on it.
# Under 'Partitioning', select 'I will configure partitioning'.
# Click 'Done'.
# Under 'New mount points will use the following partitioning scheme', change 'LVM' to 'Btrfs'.
# If there are already any partitions on the disk, you will have to select each one and click '-' on each one until the disk is empty.
# We want to use the whole drive. At the top of the list, click 'Click here to create them automatically'. This will automatically create the correct partitions using the whole drive.
# Click 'Done'.
# A list of what will be done during the installation will appear which you can review. If you are happy, click 'Accept Changes'.

=== Disable kdump ===

I have no use for kdump so will be disabling it.

# Click '''KDUMP'''.
# Untick the 'Enable kdump' box.
# Click 'Done'.

=== Setting the network hostname ===

The rest of the network settings should be OK unless you have something custom to configure. We will just be changing the hostname.

# Click '''NETWORK AND HOSTNAME'''.
# In the hostname box, replace 'freepbx.sangoma.local' to the hostname of your network (for example freepbx.freddythechick.net).
# Click 'Apply'.
# Click 'Done'.

=== Starting the installation ===

# If there is any problems preventing installation, there will be a yellow bar at the bottom of the screen saying where the problem is and the section that has the problem will have a yellow exclamation mark. These sections will need fixing before you can continue.
# I have added a picture of what the screen should look like for reference once everything is configured.
# If you are happy with all of the settings, click 'Begin Installation'.

=== Entering a root password ===

The installation will start. While the installation continues, we need to set the root password. This will not stop the installation while you are setting this up but must be done before the installation is finished.

# Click '''ROOT PASSWORD'''.
# Type a password for the root user in the 'Root Password:' box.
# Retype the password in the 'Confirm:' box.
# Click 'Done'.

This will be an internet facing machine, even more so if exposing SSH so it is '''HIGHLY RECOMMENDED''' to type a password that fills the strength bar so that it says '''Strong'''. Use a combination of uppercase letters, lowercase letters, numbers and symbols and make the password as long as you can possibly remember. Do not use common words that may be in the dictionary or names. If you do, you will be warned with a yellow bar at the bottom and will be asked to click 'Done' again. It is '''HIGHLY RECOMMENDED''' to use a different password if you are warned of this as you will be at risk of attack.

=== Completing the installation ===

You will now be back at the installation screen - grab a cup of coffee and wait for the installation to finish.

Once the installation is finished, it will say 'SangomaOS 7.8 is now successfully installed and ready to use! Go ahead and reboot to start using it!'. Click the 'Reboot' button and the machine will reboot to the FreePBX terminal. Remember to remove the DVD/image from the drive!

== First run of the web interface ==

# Open a browser on a machine on the same network and go to the IP address of the machine. For example, if the machine is at <code>192.168.1.45</code>, type <code>http://192.168.1.45</code> into the address bar. If you are not sure of the address, login to the server as root and it will display the IP address of the machine. This is the first time of using the web interface so we need to set up a few items. Ignore any warnings about the server certificate - this can be set up later.
# Type a username into the '''Username''' field. Avoid common usernames, such as admin and user as these are easily guessed if your server is attacked.
# Type a password into the '''Password''' and '''Confirm Password''' fields. Make sure this is strong, especially if you plan to make the admin pages web facing at a latter date.
# Type an e-mail address into the '''Notifications Email address''' field. This is used if there are any critical errors on the server and to inform you of automatic system updates.
# You can change the '''System Identifier''' to something else if you like, this is especially handy if managing more than one FreePBX server.
# Choose your settings to enable automatic updates as you would like for your system.
# When done, click 'Setup System' in the bottom right hand corner.
# This will take you to the home page for the server. To administer the system, click 'FreePBX Administration' and log in with the details you typed just now.
# You will now be asked if you would like to activate the system with Sangoma. This is recommended to activate some of the modules we will be using later. Click 'Activate'.
# Type your e-mail address. If you already have an e-mail account with Sangoma, wait a few seconds and type your password when the box comes up. Fill in any missing details if needed then click 'Continue'. If you don't already have an account, you will have to fill in your details and click 'Create'.
# Under 'New Activation', type a location and then click 'Activate'. If you are re-installing an already activated system, you can go to 'Existing Deployment' and type the deployment number already activated there.
# Once you have clicked 'Activate', it will then display a deployment number. This means it is successfully deployed. The deployment number can be displayed later if needed.
# Click 'Skip' on the module updates for now as we need to set up the server first.
# Leave '''Sound Prompts Language''' as 'English (United Kingdom)' or change this from the drop down menu if wrong.
# Leave '''System Language''' as 'English (United Kingdom)' or change to this from the drop down menu if wrong.
# The '''Timezone''' option should already be correct from our installation. If not, it can be corrected here to 'Europe/London'.
# Click 'Submit' in the bottom left hand corner. It will take a while as it is starting to setup the system - be patient!
# Unless you want to set up the firewall, click 'Abort'.
# You may get a few adverts after this - click 'Not Now' to skip them.
# Your system is now basically set up - you will be presented with the dashboard.
# If there is a red 'Apply Now' button in the top right hand corner, press this to configure the system with the changes just implemented.

== Updating the server ==

=== Updating using CentOS system updates (OPTIONAL) ===

The FreePBX distribution is based on CentOS 7.8, however, FreePBX very rarely, if ever, provide updates to the system unless they upgrade the distribution. You can configure the system to update using CentOS repositories for a more up-to-date and secure system.

'''WARNING: If you are using anything the uses kernel modules (i.e. DAHDI modules), please do not use this method to update - this will cause the modules to break as they rely on the kernel supplied to operate.'''

I do not use anything that relies on the kernel so shall be applying these updates.

==== Add the CentOS 7 update repository ====

* At the terminal, type the following command:
yum-config-manager --add-repo https://www.mirrorservice.org/sites/mirror.centos.org/7/updates/x86_64/
* We need to add the GPG key for this repository to be trusted. Type the following command:
gpg --quiet --with-fingerprint /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
You should see a key displayed.
* Import the key so the system trusts it, type:
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
* We now want to clear the yum cache so that it picks up the new repository. Type:
yum clean all
* You can now follow the next step to update the system.

=== General updates ===

As with any Linux distribution, from time to time there are updates to the system. This will show you how to check these and install them.

# Login to the system at the terminal or SSH as root.
# Type <code>yum update</code>.
# After downloading the update lists from the internet, a list may be shown showing the latest updates available. If <code>No Packages marked for Update</code> is shown, there are no updates available right now and you can continue to the next step.
# If there are updates offered, type <code>y</code> to accept the changes. The updates will then be downloaded and installed. Some packages take a long time to install and the system will look like it has hung. Be patient, they will eventually install.
# It is recommended that once the update is finished, you reboot the machine so that the updates are applied. Type <code>reboot</code>.

=== Updating FreePBX modules ===

# From the dashboard, on the menu bar, go to '''Admin > Module Admin'''.
# Click 'Check Online' to check the internet for updated modules.
# Once done, click 'Upgrade all' on the right-hand side to mark all modules for update.
# Click 'Process' to start updating the modules.
# You will be presented with a list of modules to be updated. Scroll to the bottom and click 'Confirm'
# Some updates take a very long time to complete, please be patient! Avoid refreshing or going back or the server could be left in an inconsistent state.
# Once the current updates are complete, press 'Return' to be taken back to the Module Admin screen.
# Click the red 'Apply Config' button at the top right of the screen.
# Some updates rely on other packages to be updated first. Keep cycling through these steps until there are no more packages to update.

=== Upgrading to FreePBX 16 ===

At the moment, FreePBX 16 is not available separately so we need to upgrade to FreePBX 16 through FreePBX 15. This can only be done once the system is updated. The biggest change of this upgrade is now supporting the modern PHP 7.4 instead of the now legacy and unsupported PHP 5.6.

# From the dashboard, on the menu bar, go to '''Admin > Module Admin'''.
# Click 'Check Online' to check the internet for updated modules.
# Under the 'Admin' section, look for a module called 'PBX Upgrader'.
# Click the > to expand the entry.
# Change 'No Action' to 'Download and Install'.
# Go to the top of the page and on the right-hand side, click 'Process'.
# Click 'Confirm' to install the module.
# Once it has completed, press 'Return' to be taken back to the Module Admin screen.
# Click the red 'Apply Config' button at the top right of the screen.
# On the menu bar, go to '''Admin > 15 to 16 Upgrade Tool'''.
# Click the 'Check the requirements!' button.
# Once it has checked, if all is well, click the 'Proceed to the upgrade process'. If anything comes back with an error, this will need fixing before proceeding.
# Although you have not changed the system yet, it may complain about not using standard repositories. Under 'Non-standard Repository Servers', leave as 'Reset the repos to the defaults.
# Click 'Next'.
# Fill out any details you would like for the survey (this is optional), or press skip.
# Read the warning message and then press 'OK' when ready to upgrade.
# Please be patient, ignore any error messages and do not think the system has hung, this process can take a long time to complete. If the webpage does fail during the upgrade and you cannot access the progress of the upgrade, go to the terminal and type <code>tails -f /var/log/pbx/freepbx16-upgrade.log</code> which should allow you to follow the update. Once done, return to the dashboard.
# Now is a good time to once again reboot the system to apply all the changes.
# Once rebooted, check for module updates as per previous section.

=== Upgrading to the latest Asterisk version ===

Once all the updates have been installed on the distribution, we can upgrade the version of Asterisk to the Asterisk 18 which is the latest version as of writing.

# Login to the system at the terminal or SSH as root.
# From the terminal, type <code>asterisk-version-switch</code>.
# Select the number next to the version that you would like to install - e.g. <code>7</code> for Asterisk 18 then hit enter.
# Wait for the script to run through upgrading Asterisk.
# When returned to the terminal, restart the machine to apply the new changes.

OpenSUSE Leap 15.6

2024-08-17T22:48:06Z

Sam: /* Previous supported versions (at time of release) */ Corrected date

This is the Linux distribution my server is based on. More information is available [https://www.opensuse.org/ here].

If you are looking to install openSUSE, there are more details in [[obtaining openSUSE Leap 15.6]].

== Changes to openSUSE ==

=== Closing the Gap ===

Starting with Leap 42.1, work commenced to align openSUSE Leap's code using SUSE Enterprise Linux as the base code. This [https://www.suse.com/c/closing-the-leap-gap-src/ Closing the Leap Gap] project has finally taken shape in openSUSE 15.3 with this release using SUSE Linux Enterprise packages where possible. You will notice this with the additional update repositories that are added in this release. This will allow stable releases to be built based on the rock solid reliability of SUSE Linux Enterprise.

Releases are now in line with SUSE Enterprise Linux, with openSUSE 15.4, openSUSE 15.5 and openSUSE 15.6 now expected to align with the SUSE Enterprise Linux releases instead of the anticipated jump to openSUSE 16.0 as would have happened before.

32-bit versions are no longer available, only 64-bit (x86_64) now. SUSE Enterprise Linux has not supported 32-bit for a long time and being more in line with SUSE Enterprise Linux, openSUSE now shares this trait. Most modern CPU's now support 64-bit (Intel Pentium 4's with the Prescott 2M core from 2005 onwards support x86_64). The rolling release, [[openSUSE Tumbleweed]] still supports 32-bit versions if needed.

=== Last 15.x Release ===

This is expected to be the last release in the 15.x branch. The next version of openSUSE Leap is expected to be 16.0 with some large changes to how the operating system operates expected.

== Installation notes/Known Issues ==

Due to the Closing the Leap Gap Project, there have been some major changes within the system that have presented issues while installing this version.

* If upgrading, check the "Unneeded Packages" category in YaST once upgraded to remove any lingering unneeded packages from the previous version.
* MariaDB now uses system authentication for the root user - just login as root then type <code>mariadb</code>. You will be logged in automatically. This differs from before where the root password needed setting before you could use it.
* To enable TLS in Apache, the following flags need adding to <code>sysconfig</code>. Edit <code>/etc/sysconfig/apache2</code> and edit this line:<br>
APACHE_SERVER_FLAGS="SSL HTTP2"
* YaST does not prompt for a root user password for Samba as previous versions did. This can be set up manually with <code>smbpasswd -a root</code>.
* <code>samba-ad-dc</code> was removed in the previous release. It was removed from SuSE Linux 15 SP5 as it was only a technical preview so does not appear in openSUSE Leap 15.5. This is important if you implemented AD DC in previous versions.

== Release notes ==

[[openSUSE Leap 15.6 Release Notes|Release Notes]]

== Information ==

openSUSE Leap 15.6 was released on 12th June 2024. It is an open-source distribution and is free of charge. It is developed by the community and sponsored by [https://www.eqtgroup.com/ EQT Partners] (formally Micro Focus and Novell).

== Previous supported versions (at time of release) ==

* [[openSUSE Leap 15.5]] (Supported until 31st December 2024)
* [[openSUSE Tumbleweed]] (Rolling release)
<br>
[[File:openSUSE Leap 15.6 webpage.png|center|400px]]

Making a English Wikipedia server

2024-08-13T23:52:43Z

Sam: /* Finish configuring LocalSettings.php */ Added extra option for ParserFunctions

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entirely on the English Wikipedia, but should be quite relevant for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preparation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-<date>-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon
* The following extra extensions need to be downloaded, extracted and dropped in the extensions folder:
** [https://www.mediawiki.org/wiki/Extension:MassMessage MassMessage]
** [https://www.mediawiki.org/wiki/Extension:TemplateStyles TemplateStyles]
** [https://www.mediawiki.org/wiki/Extension:JsonConfig JsonConfig]
** [https://www.mediawiki.org/wiki/Extension:MobileFrontend MobileFrontend]

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving database to a different hard drive ===

Due to the sheer size of the database, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a separate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
*** ParserFunctions
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed successfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Change <code>$wgEnableUserEmail</code> to <code>false</code>
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP time zone - in our case, <code>Europe/London</code>
* Add under <code>$wgGroupPermissions['*']['edit'] = false;</code>:
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'Math' );</code>:
$wgDefaultUserOptions['math'] = 'mathml';
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'ParserFunctions' );</code>:
$wgPFEnableStringFunctions = true;
* Add under <code>wfLoadExtension( 'Scribunto' );</code>:
$wgScribuntoDefaultEngine = 'luastandalone';
$wgScribuntoEngineConf['luastandalone']['cpuLimit'] = '60'; # Allows lua scripts to run for 60 seconds - needed during import
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;
* Add the following block at the end - this allows larger modules to be uploaded without errors:
$wgMaxArticleSize = 4096; # Size in kb
$wgAPIMaxResultSize = 4096000; # Size in b

Go back to the website and check that it is still functional. If you are greeted by a blank page, the most common reason is a missing <code>;</code> at the end of a line - all lines must end with a <code>;</code>.

== Importing the dump ==

Making a English Wikipedia server

2024-08-13T23:49:26Z

Sam: /* Install Mediawiki */ Added ParserFunctions to extensions list

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entirely on the English Wikipedia, but should be quite relevant for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preparation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-<date>-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon
* The following extra extensions need to be downloaded, extracted and dropped in the extensions folder:
** [https://www.mediawiki.org/wiki/Extension:MassMessage MassMessage]
** [https://www.mediawiki.org/wiki/Extension:TemplateStyles TemplateStyles]
** [https://www.mediawiki.org/wiki/Extension:JsonConfig JsonConfig]
** [https://www.mediawiki.org/wiki/Extension:MobileFrontend MobileFrontend]

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving database to a different hard drive ===

Due to the sheer size of the database, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a separate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
*** ParserFunctions
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed successfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Change <code>$wgEnableUserEmail</code> to <code>false</code>
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP time zone - in our case, <code>Europe/London</code>
* Add under <code>$wgGroupPermissions['*']['edit'] = false;</code>:
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'Math' );</code>:
$wgDefaultUserOptions['math'] = 'mathml';
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'Scribunto' );</code>
$wgScribuntoDefaultEngine = 'luastandalone';
$wgScribuntoEngineConf['luastandalone']['cpuLimit'] = '60'; # Allows lua scripts to run for 60 seconds - needed during import
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;
* Add the following block at the end - this allows larger modules to be uploaded without errors:
$wgMaxArticleSize = 4096; # Size in kb
$wgAPIMaxResultSize = 4096000; # Size in b

Go back to the website and check that it is still functional. If you are greeted by a blank page, the most common reason is a missing <code>;</code> at the end of a line - all lines must end with a <code>;</code>.

== Importing the dump ==

Making a English Wikipedia server

2024-08-13T19:53:05Z

Sam: /* Finish configuring LocalSettings.php */ Added large article part to LocalSettings.php

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entirely on the English Wikipedia, but should be quite relevant for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preparation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-<date>-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon
* The following extra extensions need to be downloaded, extracted and dropped in the extensions folder:
** [https://www.mediawiki.org/wiki/Extension:MassMessage MassMessage]
** [https://www.mediawiki.org/wiki/Extension:TemplateStyles TemplateStyles]
** [https://www.mediawiki.org/wiki/Extension:JsonConfig JsonConfig]
** [https://www.mediawiki.org/wiki/Extension:MobileFrontend MobileFrontend]

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving database to a different hard drive ===

Due to the sheer size of the database, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a separate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed successfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Change <code>$wgEnableUserEmail</code> to <code>false</code>
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP time zone - in our case, <code>Europe/London</code>
* Add under <code>$wgGroupPermissions['*']['edit'] = false;</code>:
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'Math' );</code>:
$wgDefaultUserOptions['math'] = 'mathml';
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'Scribunto' );</code>
$wgScribuntoDefaultEngine = 'luastandalone';
$wgScribuntoEngineConf['luastandalone']['cpuLimit'] = '60'; # Allows lua scripts to run for 60 seconds - needed during import
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;
* Add the following block at the end - this allows larger modules to be uploaded without errors:
$wgMaxArticleSize = 4096; # Size in kb
$wgAPIMaxResultSize = 4096000; # Size in b

Go back to the website and check that it is still functional. If you are greeted by a blank page, the most common reason is a missing <code>;</code> at the end of a line - all lines must end with a <code>;</code>.

== Importing the dump ==

Making a English Wikipedia server

2024-08-12T02:53:12Z

Sam: Spell checked

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entirely on the English Wikipedia, but should be quite relevant for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preparation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-<date>-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon
* The following extra extensions need to be downloaded, extracted and dropped in the extensions folder:
** [https://www.mediawiki.org/wiki/Extension:MassMessage MassMessage]
** [https://www.mediawiki.org/wiki/Extension:TemplateStyles TemplateStyles]
** [https://www.mediawiki.org/wiki/Extension:JsonConfig JsonConfig]
** [https://www.mediawiki.org/wiki/Extension:MobileFrontend MobileFrontend]

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving database to a different hard drive ===

Due to the sheer size of the database, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a separate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed successfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Change <code>$wgEnableUserEmail</code> to <code>false</code>
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP time zone - in our case, <code>Europe/London</code>
* Add under <code>$wgGroupPermissions['*']['edit'] = false;</code>:
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'Math' );</code>:
$wgDefaultUserOptions['math'] = 'mathml';
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'Scribunto' );</code>
$wgScribuntoDefaultEngine = 'luastandalone';
$wgScribuntoEngineConf['luastandalone']['cpuLimit'] = '60'; # Allows lua scripts to run for 60 seconds - needed during import
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;

Go back to the website and check that it is still functional. If you are greeted by a blank page, the most common reason is a missing <code>;</code> at the end of a line - all lines must end with a <code>;</code>.

== Importing the dump ==

Making a English Wikipedia server

2024-08-12T02:48:17Z

Sam: /* Downloading and installing MediaWiki */ Added extra extensions

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entierly on the English Wikipedia, but should be quite relevent for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preperation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-(date)-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon
* The following extra extensions need to be downloaded, extracted and dropped in the extensions folder:
** [https://www.mediawiki.org/wiki/Extension:MassMessage MassMessage]
** [https://www.mediawiki.org/wiki/Extension:TemplateStyles TemplateStyles]
** [https://www.mediawiki.org/wiki/Extension:JsonConfig JsonConfig]
** [https://www.mediawiki.org/wiki/Extension:MobileFrontend MobileFrontend]

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving databse to a different hard drive ===

Due to the sheer size of the databse, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a seperate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed sucessfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Change <code>$wgEnableUserEmail</code> to <code>false</code>
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP timezone - in our case, <code>Europe/London</code>
* Underneath <code>$wgGroupPermissions['*']['edit'] = false;</code>, add the following
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'Math' );</code>:
$wgDefaultUserOptions['math'] = 'mathml';
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'Scribunto' );</code>
$wgScribuntoDefaultEngine = 'luastandalone';
$wgScribuntoEngineConf['luastandalone']['cpuLimit'] = '60'; # Allows lua scripts to run for 60 seconds - needed during import
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;

Go back to the website and check that it is still functional. If you are greeted by a blank page, the most common reason is a missing <code>;</code> at the end of a line - all lines must end with a <code>;</code>.

== Importing the dump ==

Making a English Wikipedia server

2024-08-12T02:44:21Z

Sam: /* Finish configuring LocalSettings.php */ Added check website

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entierly on the English Wikipedia, but should be quite relevent for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preperation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-(date)-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving databse to a different hard drive ===

Due to the sheer size of the databse, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a seperate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed sucessfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Change <code>$wgEnableUserEmail</code> to <code>false</code>
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP timezone - in our case, <code>Europe/London</code>
* Underneath <code>$wgGroupPermissions['*']['edit'] = false;</code>, add the following
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'Math' );</code>:
$wgDefaultUserOptions['math'] = 'mathml';
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'Scribunto' );</code>
$wgScribuntoDefaultEngine = 'luastandalone';
$wgScribuntoEngineConf['luastandalone']['cpuLimit'] = '60'; # Allows lua scripts to run for 60 seconds - needed during import
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;

Go back to the website and check that it is still functional. If you are greeted by a blank page, the most common reason is a missing <code>;</code> at the end of a line - all lines must end with a <code>;</code>.

== Importing the dump ==

Making a English Wikipedia server

2024-08-12T02:42:41Z

Sam: /* Preperation */ Added LocalSettings.php additions

[https://www.mediawiki.org MediaWiki] makes dumps of the English Wikipedia about once a month. As it is free and open source content, you can use these dumps to make your own server with the English Wikipedia content in it. As the English Wikipedia is the largest Wikipedia, it does take a while to import the dumps, but it is by no means impossible. This guide will help you long the way.

This guide is based entierly on the English Wikipedia, but should be quite relevent for other languages too.

== Prerequisites ==

Here is some information of a few things you need to know before you get started. It will all be covered in the instructions below.

=== What you need to know ===

You will need the following to get started:

* Apache Web Server
* PHP
* MySQL/MariaDB
* A dump of your Wikipedia of choice

You will also need the following for optimal performance:

* ICU
* ImageMagick
* git (for revision control - not strictly necessary)

=== Before you start ===

* Remember that some of the Wikipedia dumps are huge. You will need a lot of disk space (Around 100GB as a minimum for the download, around 500GB to do this comfortably once the database grows, remember that Wikipedia is always growing...)
* Prepare MySQL/MariaDB and PHP for the incoming large transactions.

== Preperation ==

=== Downloading the dumps ===

# The dumps for English Wikipedia are available from [https://dumps.wikimedia.org/enwiki/ Wikimedia Dumps]. When there, you'll obviously want to select the latest date.
# Once there, you'll need to download the following:
#* <code>enwiki-(date)-pages-articles-multistream.xml.bz2</code> (This is the latest revision of every Wikipedia page, article and template - the basics you need to get going)
# This is compressed with Bzip2 - if you have the space, extract it once downloaded to speed up importing.

=== Downloading and installing MediaWiki ===

* Download the latest version of Mediawiki from the [https://www.mediawiki.org Mediawiki] website. As were using Linux, it's better to download the .tar.gz version.
* Extract the archive
* Clear out anything not needed:
** Timeless and Mono skin
** Text files in the root, install.sh, docker...
* Copy the folder to the webroot
* Place a file in the .../resources/asset folder if using a picture for the site logo/favicon

=== Preparing the database ===

* Login to MariaDB as root
* Create the database:
CREATE DATABASE enwiki;
* Create a user for the database:
CREATE USER 'enwiki'@'localhost' IDENTIFIED BY 'database_password';
A password can be generated at [https://passwordsgenerator.net/ Password Generator Plus]. Use a length as long as possible, it doesn't need to be remembered past this configuration.
* Grant priveliges for the user to this database:
GRANT ALL PRIVILEGES ON enwiki.* TO 'enwiki'@'localhost' WITH GRANT OPTION;
* Exit MariaDB
* Restart the server
systemctl restart mariadb

This can be tweaked with different database and user names as required.

=== Moving databse to a different hard drive ===

Due to the sheer size of the databse, you may choose to move the MariaDB database to a different drive. MariaDB stores each database in a seperate folder by default making this easy.

* Stop MariaDB
systemctl stop mariadb
* Navigate to <code>/var/lib/mysql</code>
* Move the <code>enwiki</code>/database name folder to where you want the database to be stored
* Back in the <code>/var/lib/mysql</code> folder, create a symlink to where you moved the folder, using the same name for the symlink
* Chown the databse folder where you moved it to mysql:
chown -R mysql:root /path/to/folder/enwiki
* Restart MariaDB, check it starts with no errors
systemctl start mariadb

=== Install Mediawiki ===

* Navigate to where your instance is installed: for example, https://enwiki.freddythechick.net/. You will be greeted by the Mediawiki installer. Click the 'set up the wiki' link
* Choose your language then click 'Continue'
* Check the Environmental checks and fix anything flagged up here. If all is OK, you will see 'The environment has been checked. You can install MediaWiki.' in green with a tick. At this point, click 'Continue'
* Enter the database configuration:
** Database type: MariaDB, MySQL, or compatible
** Database host: localhost
** Database name (no hyphens): enwiki
** Database table prefix (no hyphens): <leave blank>
** Database username: enwiki
** Database password: <use password generated/configured earlier>
* Click 'Continue'
* On Database settings, leave the 'Use the same account as for installation' box checked and click 'Continue'
* On Name, enter the following settings:
** Name of wiki:<whatever you want your wiki to be called>
** Project namespace: Same as the wiki name
* Enter details of an account username, password and e-mail address so that you can administer the wiki later.
* Make sure 'Ask me more questions' is checked and click 'Continue'
* On Options, select the following:
** User rights profile: Account creation required (we will be further locking this down later)
** Copyright and license: Creative Commons Attribution-ShareAlike (this specific license '''MUST''' be selected if using Wikipedia's content)
** Uncheck 'Enable outbound email'
** Select Vector as the default skin with the radio button
** Check the following extensions to enable them:
*** MassMessage
*** Cite
*** Math
*** Poem
*** Scribunto
*** TemplateStyles
*** JsonConfig
*** MobileFrontend
** Check 'Enable Instant Commons'
** Change under Logo (icon) and Sidebar logo (optional) <code>change-your-logo.svg</code> to the filename of the image you dropped in the resource folder earlier. You will see a preview of it underneath
** Ensure PHP object caching (APC, APCu or WinCache) is selected
* Click 'Continue'
* Click 'Continue' to finish the install
* Ensure the installation has completed sucessfully then click 'Continue'
* A copy of the LocalSettings.php file will be downloaded automatically. This needs to be moved to the root folder of the wiki which will then make it work.
* Click 'Enter your wiki'. You will be greeted with the default MediaWiki Main page if all is well.

=== Finish configuring LocalSettings.php ===

* Open LocalSettings.php in a text editor
* Add a line to enable a favicon:
$wgFavicon = "$wgResourceBasePath/resources/assets/<logoimage.svg>";
* Change <code>$wgEnableUserEmail</code> to <code>false</code>
* Edit <code>$wgEmergencyContact</code> and <code>$wgPasswordSender</code> with your email address between the quote marks
* Change <code>$wgLocaltimezone</code> from UTC to your correct PHP timezone - in our case, <code>Europe/London</code>
* Underneath <code>$wgGroupPermissions['*']['edit'] = false;</code>, add the following
$wgGroupPermissions['*']['createaccount'] = false;
This stops user accounts being created and prevents editing by anyone other than yourself.
* Add under <code>wfLoadSkin ( 'Vector' );</code> the following:
$wgDefaultSkin = 'vector-2022';
This enables the modern Vector 2022 skin
* Add under <code>wfLoadExtension( 'JsonConfig' );</code>:
$wgJsonConfigEnableLuaSupport = true; // required to use JsonConfig in Lua
$wgJsonConfigModels['Tabular.JsonConfig'] = 'JsonConfig\JCTabularContent';
$wgJsonConfigs['Tabular.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".tab", and contain at least one symbol
'pattern' => '/.\.tab$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigModels['Map.JsonConfig'] = 'JsonConfig\JCMapDataContent';
$wgJsonConfigs['Map.JsonConfig'] = [
'namespace' => 486,
'nsName' => 'Data',
// page name must end in ".map", and contain at least one symbol
'pattern' => '/.\.map$/',
'license' => 'CC0-1.0',
'isLocal' => false,
];
$wgJsonConfigInterwikiPrefix = "commons";
$wgJsonConfigs['Tabular.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
$wgJsonConfigs['Map.JsonConfig']['remote'] = [
'url' => 'https://commons.wikimedia.org/w/api.php'
];
* Add under <code>wfLoadExtension( 'Math' );</code>:
$wgDefaultUserOptions['math'] = 'mathml';
* Add under <code>wfLoadExtension( 'MobileFrontend' );</code>:
$wgMFAutodetectMobileView = true;
$wgMFDefaultSkinClass = 'SkinMinerva';
* Add under <code>wfLoadExtension( 'Scribunto' );</code>
$wgScribuntoDefaultEngine = 'luastandalone';
$wgScribuntoEngineConf['luastandalone']['cpuLimit'] = '60'; # Allows lua scripts to run for 60 seconds - needed during import
* Add the following block at the end (leave commented out until needed for debugging for security and comment back out once debugging finished):
# Show PHP exceptions (only enable on error)
#$wgShowExceptionDetails = true;

== Importing the dump ==

Making a English Wikipedia server

2024-08-12T02:28:23Z

Sam: Saved progress so far

Making a English Wikipedia server

2024-08-12T01:55:45Z

Sam: Saved progress so far

MediaWiki:Sidebar

2024-07-24T19:48:14Z

Sam: Added navigation header

MediaWiki:Sidebar

2024-07-24T19:47:41Z

Sam: Trying to space

MediaWiki:Sidebar

2024-07-24T19:47:10Z

Sam: Removed unneeded space

MediaWiki:Common.css

2024-07-07T01:05:21Z

Sam: Removed custom font code

MediaWiki:Common.css

2024-07-07T01:03:58Z

Sam: Try adding classes

/* CSS placed here will be applied to all skins */
#ca-talk { display:none!important; }
body.page-Main_Page.action-view h1.firstHeading, body.page-Main_Page.action-submit h1.firstHeading { display: none; }

@font-face {
font-family: "Interstate Regular" !important;
src: url('../fonts/interstate-regular.woff') format('woff');
.mw-body,
.mw-headline,
.mw-label,
.mw-input,
.mw-body-content,
.mw-allpages-table-form,
.mw-allpages-nav
}

MediaWiki:Common.css

2024-07-07T01:02:37Z

Sam: Try adding important

MediaWiki:Common.css

2024-07-07T01:01:34Z

Sam: Try WOFF font

/* CSS placed here will be applied to all skins */
#ca-talk { display:none!important; }
body.page-Main_Page.action-view h1.firstHeading, body.page-Main_Page.action-submit h1.firstHeading { display: none; }

@font-face {
font-family: "Interstate Regular";
src: url('../fonts/interstate-regular.woff') format('woff');
}

MediaWiki:Common.css

2024-07-07T00:54:04Z

Sam: Shortened URL, added quotes

/* CSS placed here will be applied to all skins */
#ca-talk { display:none!important; }
body.page-Main_Page.action-view h1.firstHeading, body.page-Main_Page.action-submit h1.firstHeading { display: none; }

@font-face {
font-family: "Interstate Regular";
src: url('../fonts/INTERR.ttf') format('truetype');
}

MediaWiki:Common.css

2024-07-07T00:51:56Z

Sam: Try URL

/* CSS placed here will be applied to all skins */
#ca-talk { display:none!important; }
body.page-Main_Page.action-view h1.firstHeading, body.page-Main_Page.action-submit h1.firstHeading { display: none; }

@font-face {
font-family: Interstate Regular;
src: url('https://thinkserver.freddythechick.net/fonts/INTERR.ttf') format('truetype');
}

MediaWiki:Common.css

2024-07-07T00:50:42Z

Sam: Added local

/* CSS placed here will be applied to all skins */
#ca-talk { display:none!important; }
body.page-Main_Page.action-view h1.firstHeading, body.page-Main_Page.action-submit h1.firstHeading { display: none; }

@font-face {
font-family: Interstate Regular;
src: local ("Interstate Regular"),
url('fonts/INTERR.ttf') format('truetype');
}

MediaWiki:Common.css

2024-07-07T00:48:44Z

Sam: Try font change