Install OS4X on Ubuntu 20

From OS4X
Jump to navigation Jump to search

General

Ubuntu 20.x is supported by the automatic OS4X installer since build 2016-11-24. Older versions lack the ability to support various features of this modern operating system.

Packages

You need the following packages to be installed:

apt-get install apache2 \
mysql-server \
libapache2-mod-php \
php-mysql \
php-xml \
xsltproc \
zip

Special installation parameter

When running the automated installer script, you will have to use "localhost" instead of "127.0.0.1" in the default MySQL installation (since the MySQL user "root" isn't allowed for 127.0.01, but for localhost). You'll get the following error otherwise:

error: 'Access denied for user 'root'@'localhost

Configuration

PHP

The PHP configuration must be extended in order to use big file uploads. Edit the configuration file

/etc/php/7.4/apache2/php.ini

and set these values:

upload_max_filesize = 128M
post_max_size = 128M

Don't forget to restart Apache afterwards:

service apache2 restart

SystemD integration

Download the source tarball from https://cdn.c-works.de/fileadmin/downloads/os4x.systemd.tar, extract it /tmp. Then, copy over the files:

cp /tmp/etc/init.d/os4x /etc/init.d/
cp /tmp/etc/systemd/system/os4x.service /etc/systemd/system

Then, enable the service:

systemctl enable os4x
systemctl start os4x