This is a lightweight portal to view & manage your webapps without having to run anything more than a PHP enabled webserver. With Muximux you don't need to keep multiple tabs open, or bookmark the URL to all of your apps.
Requirements: A webserver (nginx, Apache, IIS or any other webserver) configured with PHP5 support.
parse_ini_file
must be allowed in php.ini (default is allowed!)
To set it up, clone this repository:
git clone https://github.com/mescon/Muximux
or download the ZIP-file. If you install by downloading the zip-file, Muximux will still be able to notify you of updates and install them for you (given the right directory permissions!)
Place all files on a publicly accessible webserver, either in a subdirectory called (for example) muximux
or directly in the root directory of your webserver (such as /var/www
, /var/html
, C:\Inetpub\wwwroot
or wherever your webserver serves files from by default).
Read this note about securing Muximux, and read this note about what happens if you are using HTTPS. Just do it.
Make sure that the directory where you place Muximux is writable by the process that is running your webserver. (i.e www-data, www-user, apache, nginx or whatever the user is called)
chown -R www-data.www-data /var/www/muximux
The fine people of LinuxServer.io takes care of Docker builds for Muximux. You can find their instructions here.
Navigate to http://<host>/muximux
where <host>
is either the IP or hostname of your webserver. Obviously if you put the files in the root directory of your webserver, there is no need to append /muximux
Remove the default apps (or just change the URL:s of them if you want to keep them), add your own apps by clicking in the top right corner and then click "Settings".
To refer the link to the same server that is hosting Muximix in contexts where ip / hostname I can change (local network, remote network, vpn, etc) you can write the url in the form http://{self}/<page/dir>
or http://{self}:<port>
.
At runtime {self}
will be replaced with the value contained in $_SERVER['HTTP_HOST']
.
Under Settings, rearrange your apps with drag'n'drop - just drag an item under another item to move it it.
To reload an app, double click it in the menu, or press the refresh button in the top right bar.
If you want to bookmark a specific service - or just quickly go to a service you've set up - use https://<host>/muximux/#service_name
. For instance, https://myserver.com/muximux/#couchpotato
which will load Muximux and automatically load my Couchpotato tab. Replace spaces with underscore.
There is no longer any need to edit config.ini.php or any file at all. In fact, we recommend you don't!
It is strongly recommended that you secure any exposed applications with Basic Auth (.htpasswd / .htaccess
)
Read instructions for Nginx, Apache and Microsoft IIS.
If you decide not to, Muximux disallows search engines from indexing your site, however, Muximux itself does not password protect your services, so you have to secure each of your applications properly (which they already should be!). Muximux is NOT a proxy server, and as such can not by itself secure your separate applications. However, you can password protect the Muximux application itself in the "Settings" menu. If you don't want your other services exposed to the world you must make sure that you have Basic Auth or other means of security enabled on your server.
If you are serving Muximux from a HTTPS-enabled webserver (i.ehttps://myserver.com/muximux
), all of your services must also be secured via HTTPS.
Any URL that does not start with https://
(such as http://myserver.com:5050
) will be blocked by your web-browser!
If you can, try serving Muximux from a non-secure (HTTP) webserver instead. If the apps you have configured are using HTTPS, communication with them will still be encrypted.
The only known workaround is for Chrome, Opera and Chromium-based webbrowsers.
Install the plugin "Ignore X-Frame headers" which disables the blocking of non-secure content.
Please refer to the following: https://forum.pfsense.org/index.php?topic=47167.msg248336#msg248336 then check this box: Browser HTTP_REFERER enforcement - Disable HTTP_REFERER enforcement check Now pfsense works in muximux :D (Thanks to nullredvector for the tip)
This is a PHP enabled fork of (the simpler and more lightweight) "Managethis" found here: https://github.com/Tenzinn3/Managethis
If you prefer a NodeJS version with a built-in webserver, a rewrite of Muximux (though not up to date) is available at https://github.com/onedr0p/manage-this-node