Skip to content

Using XAMPP (Windows, Linux, OSX)

GFoniX edited this page Jan 7, 2023 · 8 revisions

Using XAMPP

Download and Install Xampp

XAMPP is a free, cross-platform web server package, and can be found here:

Windows

Linux

OSX

When installing XAMPP, we only require the PHP and Apache features. You can uncheck the following options in installation if you have no need for them:

MySQL, FileZilla FTP Server, Mercury Mail Server, Tomcat, Perl, phpMyAdmin, Webalizer, Fake Sendmail...ain't nobody got time fo dat.

Install Phlex

To install the code that makes Phlex run, you can either use git to install Phlex by cloning directly from github, or you can manually download a .zip file of the application.

Either option will work, but note that if you do not use git, Phlex will not have the ability to auto-update itself.

Using Git

Assuming you have already installed git, open a git shell and navigate to the xampp/htdocs folder, and delete EVERYTHING currently in there. We don't need or want it. Now, execute the command

git clone https://github.com/d8ahazard/Phlex.git

From a zip

Download the latest stable version of Phlex or the beta.

Go into xampp/htdocs, and delete EVERYTHING.

Open the Phlex-master.zip file you downloaded, open the subfolder called "Phlex-Master", and extract all of the files from that directory into xampp/htdocs.

When done, xampp/htdocs should contain api.php, log.php, util.php - as well as folders like /cast /css /java (and a bunch more).

Logging in

That should be it. You can now restart the apache service for your webserver, and browse to your Phlex installation at http://yourserveraddress:80

To log in, enter your Plex username and password.

Existing Webservers, Miscellaneous Notes

If you are running Phlex on an existing webserver, Phlex requires PHP version 7.0 and up. You also will need to install php-xml and php-curl. In Debian/Ubuntu that means

sudo apt-get install php7.0-xml php7.0-curl

Phlex will also require r/w access to the root of the /Phlex directory for configuration and logging purposes.

sudo chown -R var-www /var/www/Phlex

For whatever port(s) you choose to host Phlex on, make sure to listen to them in /etc/apache2/ports.conf. Certbot is highly recommended to enable SSL for your site.

You will also need the CURL and openSSL extensions enabled, and sockets if you have any Cast devices. If you're not using Xampp, you may also need to enable the xml module.