ABOUT
=====
Wrapmin is a wrapper for (Webmin)
With Wrapmin you can use Webmin inside your site.
ex: http://www.yoursite.com/webmin

Wrapmin is very useful if, for example, you are behind a firewall with a restriction to only port 80, or any other port,
and you can not redirect Webmin Through ssh because another process, like Apache, is running on that port.

REQUIREMENTS
============
You need to have Apache installed with PHP, and of course Webmin needs to be properly installed.

INSTALLATION
============
Unzip the files into some directory inside your site
ex: www.yoursite.com/webmin

Open config.php and change the values for the Webmin server and port if necessary.
The default values are "localhost" and port "10000". These are also the default installation values for Webmin.
Change the user and password values to the Webmin user that you want to use.

Go to Webmin Configuration -> Authentication (http://localhost:10000/webmin/edit_session.cgi)
and select "Disable session authentication".


Go to  Webmin Configuration -> Anonymous Module Access (http://localhost:10000/webmin/edit_anon.cgi)
and allow anonymous access to certain modules and paths, for work with Wrapmin.

set URL path
/images

       etc etc
to the user with the rights to use the modules ("root" by default).

!!WARNING!!
-----------
Deny access to any other address except "localhost".
With http://localhost:10000/webmin/edit_access.cgi
set "Only allow from listed addresses" to "localhost".

!!WARNING!!
-----------
Protect the Wrapmin directory with .htaccess
The provided .htpasswd is by default; user "demo" with password "demo"
   CHANGE THIS USER NAME AND PASSWORD
   CHOOSE A HARD TO GUESS PASSWORD AND USERNAME
Use the following command to create the .htpasswd
 #htpasswd -c .htpasswd secretuser
Make sure you have enabled "AllowOverride AuthConfig" on httpd config.
Set the path for your .htpasswd on .htaccess
You can read about Access control at http://httpd.apache.org/docs/1.3/howto/auth.html

RECOMMENDATIONS
===============
It's recommend to use https for Wrapmin.
Look at the Apache documentation for how to setup https.

It's possible to use Wrapmin on more than one Webmin server inside your network.
Just install Wrapmin in another folder
ex: http://www.yoursite.com/webmin1
and change the values on config.php to point to that server.

LIMITATIONS
===========
It is not possible for the java applets for Filemanager and Telnet to work.
You can use an alternative file manager such as phpFileManager (http://phpfm.sourceforge.net).

.................................................................................................
Sorry for bad English, you can mail me with corrections for this document if you wish.

2005-12-12 Thank's to "P.C Yates" for adjustments on this document.