Visual apache2

Configure apache2 easily

Fork me on GitHub
What is Visual apache2?

It is a web application to configure the apache2 server.

Screenshot

The configuration of apache2 is based on plane text files. You need to know and remember the directives that tell apache2 what you want it does. When you write manually on the configuration files, you could do mistakes as typographical errors, syntax errors, etc.
Visual apache2 provides a graphical user interface (web based) to configure apache2 easily.

Visual apache2 is cross-platform as it is made as a web application. It works in any operative system that can run the apache2 server and php. The client (it could be server itself or other computer in the network) needs to support html5.

Install Visual apache2

Visual apache2 is a web application that runs on php5 + JavaScript + html5.

Before installing Visual apache2

To use Visual apache2, you need to have installed apache2, php5 and libapache2-mod-php5. You also need a web browser that supports JavaScript and html5.
Example of installation using apt-get: apt-get install apache2 php5 libapache2-mod-php5 (Remember to execute this command with root privileges)

Install Visual apache2

  1. Download the installer:
  2. Execute the installer:
    The installer should be executed with root privileges.
    bash install_visual-apache2-1.0_apt-get.sh (Remember to add the path if you are not in its directory)

Uninstall Visual apache2

The uninstaller is inside the visual apache2 directory and should be executed with root privileges. bash uninstall_visual-apache2-1.0.sh (Remember to add the path if you are not in its directory)

Install Visual apache2 1.0 manually

(Remember that you need to execute this command with root privileges)

  1. Make a backup of ports.conf: cp /etc/apache2/ports.conf /etc/apache2/ports.conf.backup
  2. Change the owner to www-data of the files used by Visual apache2: chown www-data /etc/apache2/ports.conf /etc/apache2/ports.conf.backup /etc/apache2/sites-available/ /etc/apache2/sites-enabled/ /etc/apache2/mods-enabled/
  3. Change the access to the files used by Visual apache2: chmod u+rw /etc/apache2/ports.conf /etc/apache2/ports.conf.backup /etc/apache2/sites-available/ /etc/apache2/sites-enabled/ /etc/apache2/mods-enabled/
  4. Create virtualhost for Visual apache2:
    Content of /etc/apache2/sites-available/visual-apache2-1.0
    <VirtualHost *:8000>
    	ServerName visual-apache2.net
    
    	DirectoryIndex index.php
    	DocumentRoot /var/www/visual-apache2-1.0
    	<Directory />
    		AllowOverride None
    		Order allow,deny
    		Allow from all
    	</Directory>
    
    	ErrorLog /var/www/visual-apache2-1.0/logs/error.log
    	CustomLog /var/www/visual-apache2-1.0/logs/access.log combined
    </VirtualHost>
  5. Create DocumentRoot of Visual apache2: mkdir -p /var/www/visual-apache2-1.0/logs
  6. Add port 8000 to /etc/apache2/ports.conf:
    Example of /etc/apache2/ports.conf:
    # If you just change the port or add more ports here, you will likely also
    # have to change the VirtualHost statement in
    # /etc/apache2/sites-enabled/000-default
    # This is also true if you have upgraded from before 2.2.9-3 (i.e. from
    # Debian etch). See /usr/share/doc/apache2.2-common/NEWS.Debian.gz and
    # README.Debian.gz
    
    NameVirtualHost *:80
    Listen 8000 # visual-apache2.net:8000
    Listen 80
    
    <IfModule mod_ssl.c>
        # If you add NameVirtualHost *:443 here, you will also have to change
        # the VirtualHost statement in /etc/apache2/sites-available/default-ssl
        # to <VirtualHost *:443>
        # Server Name Indication for SSL named virtual hosts is currently not
        # supported by MSIE on Windows XP.
        Listen 443
    </IfModule>
    
    <IfModule mod_gnutls.c>
        Listen 443
    </IfModule>
  7. Enable virtual host: /usr/sbin/a2ensite visual-apache2-1.0
  8. Download and extract Visual apache2: wget http://binary-sequence.github.com/webapp-visual-apache2/downloads/visual-apache2-1.0.tar.gz
    tar -xzf visual-apache2-1.0.tar.gz -C /var/www/visual-apache2-1.0/
    rm visual-apache2-1.0.tar.gz
  9. Add 'visual-apache2.net' host on /etc/hosts:
    Example of /etc/hosts:
    127.0.0.1	localhost
    127.0.0.1	visual-apache2.net
    
    # The following lines are desirable for IPv6 capable hosts
    ::1     ip6-localhost ip6-loopback
    fe00::0 ip6-localnet
    ff00::0 ip6-mcastprefix
    ff02::1 ip6-allnodes
    ff02::2 ip6-allrouters
    					
  10. Restarting apache2 daemon: service apache2 restart
  11. Use your html5 compatible browser:
    Example: google-chrome http://visual-apache2.net:8000
User manual
The user manual is not written yet.
Contribute to visual apache2
If you want to contribute, follow these steps:
  1. Fork Visual apache2 on github.
  2. Create an issue on visual apache2 github repository if you find any error or if you have an idea to make it better.
  3. Make changes on your repo and request a pull.