froxlor / froxlor-installer

A simple shell installer for froxlor

Froxlor

The server administration software for your needs. Developed by experienced server administrators, this panel simplifies the effort of managing your hosting platform.

Installation

Fast install

1. Ensure that your webserver serves /var/www/html
2. Extract froxlor into /var/www/html
3. Point your browser to http://[ip-of-webserver]/froxlor
4. Follow the installer
5. Login as administrator
6. Have fun!

If you have chosen to do the configuration by hand during the installation, you have to complete some more steps:

1. Adjust "System > Settings" according to your needs
2. Choose your distribution under "System > Configuration"
3. Follow the steps for your services

Detailed installation

https://docs.froxlor.org/latest/general/installation/

Help

You may find help in the following places:

Discord

The froxlor community discord server can be found here: https://discord.froxlor.org

Forum

The community is located on https://forum.froxlor.org/

Documentation

The documentation may be found at https://docs.froxlor.org/

License

May be found in COPYING

Downloads

Tarball

https://files.froxlor.org/releases/froxlor-latest.tar.gz MD5 SHA1

Debian / Ubuntu repository

HowTo

Debian

apt -y install apt-transport-https lsb-release ca-certificates curl gnupg
curl -sSLo /usr/share/keyrings/deb.froxlor.org-froxlor.gpg https://deb.froxlor.org/froxlor.gpg
sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.froxlor.org-froxlor.gpg] https://deb.froxlor.org/debian $(lsb_release -sc) main" > /etc/apt/sources.list.d/froxlor.list'

Ubuntu

apt -y install apt-transport-https lsb-release ca-certificates curl gnupg
curl -sSLo /usr/share/keyrings/deb.froxlor.org-froxlor.gpg https://deb.froxlor.org/froxlor.gpg
sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.froxlor.org-froxlor.gpg] https://deb.froxlor.org/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/froxlor.list'

Contributing

see here

froxlor-installer's Issues

Install script shows only html-code

If I execute
sudo apt-get install default-mysql-server php php-mysql php-xml php-mbstring php-curl php-bcmath php-zip
and:
php froxlor-install.phar

I get only some HTML code
What's missing?

tried on xubuntu focal and Debian11 with php7.4

Install services error

Install script worked so far:

Froxlor is set up. Please open http://xxxxx/froxlor in your browser
To configure services, run 'php /var/w...

Executing showed this error:
...
php /var/www/froxlor/froxlor/install/scripts/config-services.php --froxlor-dir=/var/www/froxlor/froxlor/ --create
PHP Parse error: syntax error, unexpected '1' (T_LNUMBER) in /var/www/froxlor/froxlor/install/scripts/config-services.php on line 31
...

[feature-request] Installer with nginx

Can the installer support nginx?
I had to modify the config file:

sed -i -e 's|root /var/www/html|root /var/www/froxlor|g' /etc/nginx/sites-enabled/default --follow-symlinks
sed -i -e 's/#location/location/g' /etc/nginx/sites-enabled/default --follow-symlinks
sed -i -e 's|#location ~ \.php|location ~ \.php|g' /etc/nginx/sites-enabled/default --follow-symlinks
sed -i -e 's|#\tinclude sni|\tinclude sni|g' /etc/nginx/sites-enabled/default --follow-symlinks
sed -i -e 's|#\tfastcgi_pass unix|\tfastcgi_pass unix|g' /etc/nginx/sites-enabled/default --follow-symlinks
sed -i -z -e 's|9000;\n\t#|9000;\n\t|g' /etc/nginx/sites-enabled/default --follow-symlinks
sed -i -E 's|(^\sindex )|\1index.php |g' /etc/nginx/sites-enabled/default --follow-symlinks

and removed one '#' manually

to get froxlor running with nginx after the install script

If I use apache first and change to nginx after froxlor install script, will
php /var/www/froxlor/froxlor/install/scripts/config-services.p....
configure nginx ?

Install script changes mysql root password?

Issue is outlined here - https://forum.froxlor.org/index.php?/topic/19744-used-install-script-now-my-mysql-root-password-is-not-working

I tried this install script the first time, it reset my root mysql password.
I reset the mysql root password, ensured I could log in as root and ran the install script again but it failed.

Error:

I cannot log in to mysql as root, using the password that I reset it to?

Script not working anymore due to outdated SQL query

I've tried to use this script to set up a new Froxlor instance today, and encountered the following serious issues:

• The SQL query for creating the admin user is broken, therefore the admin user is not being created. The reason for that seems to be that the query contains fields which do not exist anymore in the database: tickets and tickets_see_all
• The installer doesn't report that the query fails, it just shows "[ok]". It should check whether the query has succeeded and report the failure to the user.
• Passwords (at least for the unprivileged DB user and the admin password) are converted to lowercase by the script. This is clearly a bad idea.

Please remove the reference to the script from the Froxlor install page until it is functional again, as users might be irritated why they are unable to log in to their instance.

Issue installing Froxlor on OL8

To install Froxlor on an EL8 system:

Since I'm using php7.4:

1. dnf module install php:7.4
2. dnf install -y mariadb-server
3. systemctl enable --now mariadb
4. /usr/bin/mysql_secure_installation
5. php froxlor-install.phar

Which generates the error that follows. This error is thrown after the installer connects to the database server correctly, creates a froxlor database, then fails.

[root@web1-fx ~]# php froxlor-install.phar
*
* Starting Froxlor shell-installer v0.2-alpha...
*
Checking PHP-version ...[ok]
Checking PHP PDO extension ...[ok]
Checking PHP session extension ...[ok]
Checking PHP ctype extension ...[ok]
Checking PHP simplexml extension ...[ok]
Checking PHP xml extension ...[ok]
Checking PHP filter extension ...[ok]
Checking PHP posix extension ...[ok]
Checking PHP mbstring extension ...[ok]
Checking PHP curl extension ...[ok]
Checking PHP json extension ...[ok]
Checking PHP bcmath extension ...[ok]
Checking PHP zip extension ...[ok]

Please enter the directory where Froxlor shall be installed to [/root]:/var/www/html
Would you like to download Froxlor now? [Y/n]:Y
--2020-12-23 11:41:45--  https://files.froxlor.org/releases/froxlor-latest.tar.gz
Resolving files.froxlor.org (files.froxlor.org)... 185.123.52.110, 2a10:ec2::185:123:52:110
Connecting to files.froxlor.org (files.froxlor.org)|185.123.52.110|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 2509820 (2.4M) [application/x-gzip]
Saving to: _/tmp/froxlor-latest.tar.gz_

/tmp/froxlor-latest.tar.gz              100%[=============================================================================>]   2.39M  12.4MB/s    in 0.2s

2020-12-23 11:41:46 (12.4 MB/s) - _/tmp/froxlor-latest.tar.gz_ saved [2509820/2509820]

--2020-12-23 11:41:46--  https://files.froxlor.org/releases/froxlor-latest.tar.gz.sha1
Resolving files.froxlor.org (files.froxlor.org)... 185.123.52.110, 2a10:ec2::185:123:52:110
Connecting to files.froxlor.org (files.froxlor.org)|185.123.52.110|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 65 [application/x-gzip]
Saving to: _/tmp/froxlor-latest.tar.gz.sha1_

/tmp/froxlor-latest.tar.gz.sha1         100% [=============================================================================>]      65  --.-KB/s    in 0s

2020-12-23 11:41:46 (179 MB/s) - _/tmp/froxlor-latest.tar.gz.sha1_ saved [65/65]

Extracting froxlor to /var/www/html/froxlor
Enter the domain under wich Froxlor shall be reached, this normally
is the FQDN (Fully Qualified Domain Name) of your system.
If you don't know the FQDN of your system, execute 'hostname -f'.
This installscript will try to guess your FQDN automatically if
you leave this field blank, setting it to the output of 'hostname -f'
Enter your system's hostname [web1-fx.ger.domain.io]:
Enter the IP address of your system, under wich all
websites shall then be reached. This must be the same
IP address the domain you inserted above points to.
You *must* set this to your correct IP address.
Enter your system's ip-address [A.B.C.D]:
Enter the IP address of the MySQL server, if the MySQL
server is on the same machine, enter 'localhost' or
simply leave the field blank.
Enter mysql-host address [localhost]:
Enter the username of the MySQL root user.
The default is 'root'.
MySQL root user [root]:
Enter the password of the MySQL root user:...
Enter the password of the MySQL root user again:...
Testing MySQL root connection
Database connection successful
Enter the name of the database you want to use for Froxlor. The default is 'froxlor'
MySQL database name [froxlor]:froxlor_server1
Enter the username of the unprivileged MySQL user you want Froxlor to use.
The default is 'froxlor'.
CAUTION: any user with that name will be deleted!
MySQL unprivileged user [froxlor]:froxlor_user1
Enter the password of the MySQL unprivileged user:...
Enter the password of the MySQL unprivileged user again:...
Enter the username of the admin user you want in your Froxlor panel.
Default is 'admin'.
Froxlor admin user [admin]:
Enter the password of the Froxlor admin user:...
Enter the password of the Froxlor admin user again:...
Webserver user name [www-data]:apache
Preparing SQL database files ...
[ok]
Creating froxlor database ...
[ok]
Installing SQL database files ...
[ok]
Database error: PDOException: SQLSTATE[HY000] [1044] Access denied for user 'froxlor_user1'@'localhost' to database froxlor_server1' in phar:///root/froxlor-install.phar/installer.php:537
Stack trace:
#0 phar:///root/froxlor-install.phar/installer.php(537): PDO->__construct()
#1 phar:///root/froxlor-install.phar/installer.php(141): Action->_installBaseData()
#2 phar:///root/froxlor-install.phar/installer.php(99): Action->_run()
#3 phar:///root/froxlor-install.phar/classes/class.CmdLineHandler.php(157): Action->__construct()
#4 phar:///root/froxlor-install.phar/classes/class.CmdLineHandler.php(73): CmdLineHandler->_createAction()
#5 phar:///root/froxlor-install.phar/classes/class.CmdLineHandler.php(46): CmdLineHandler->__construct()
#6 phar:///root/froxlor-install.phar/installer.php(635): CmdLineHandler::processParameters()
#7 /root/froxlor-install.phar(9): include('phar:///root/fr...')
#8 {main}