Amahi 7 Create Manual Web App

From Amahi Wiki
Revision as of 18:50, 17 November 2013 by Bigfoot65 (talk | contribs)
Jump to: navigation, search
Warning.png WARNING
This is recommended for advanced users only, please proceed with caution.



To accommodate those users who need the manual web app feature currently not available in Amahi 7, the following guidance is provided. This has been tested and no issues were noted.

Choose a name for your app. It should be short, lowercase, and do not use spaces. For example, head_phones or headphones are acceptable names. (remember to replace all occurrences of appname below with your desired name).

NOTE: There is no guarantee this will work for you or not cause problems with your Amahi 7 install. Please proceed with caution as carelessness could render your HDA inoperable.

As root user, perform the following steps:

  • Build directory structure
mkdir -p /var/hda/web-apps/appname
mkdir -p /var/hda/web-apps/appname/html
mkdir -p /var/hda/web-apps/appname/logs
chown -R apache:users /var/hda/web-apps/appname
chown -R apache:users /var/hda/web-apps/appname/html
touch /var/hda/web-apps/appname/logs/access_log
touch /var/hda/web-apps/appname/logs/error_log
chown -R /var/hda/web-apps/appname/logs/access_log
chown -R /var/hda/web-apps/appname/logs/error_log
  • Create Apache configuration file (use your favorite editor)
vi /etc/httpd/conf.d/9999-appname.conf
Insert the text below (remember to change all occurrences of appname accordingly)
<VirtualHost *:80>

        ServerName appname
        ServerAlias appname.amahi.net

        DocumentRoot /var/hda/web-apps/appname/html

        <Directory "/var/hda/web-apps/appname/html">
                Options Indexes FollowSymLinks MultiViews
                AllowOverride AuthConfig
                Require all granted

        </Directory>

        ErrorLog  /var/hda/web-apps/appname/logs/error_log
        CustomLog /var/hda/web-apps/appname/logs/access_log combined env=!dontlog

</VirtualHost>
Change permissions and restart Apache
chown apache:users /etc/httpd/conf.d/9999-appname.conf
service httpd restart
  • Update Amahi 7 database settings


The id field is set to 99 for this example. It can be any number not currently used by Amahi. Recommend you keep it at 99 or greater to be safe.
Ensure you replace appname accordingly and the date can be changed providing you follow the format. If you changed the .conf file name, ensure it matches as well.
To do a quick check, you can do the following for each table:
echo "select max(id) from dns_aliases" | mysql -uroot -phda hda_production
echo "select max(id) from webapps" | mysql -uroot -phda hda_production
Once you have chosen the id number, execute the following
echo "INSERT INTO `dns_aliases` (`id`, `name`, `address`) VALUES
(99,	'appname',	'')" | mysql -uroot -phda hda_production
echo "INSERT INTO `webapps` (`id`, `name`, `path`, `kind`, `aliases`, `fname`, `deletable`, `login_required`, `dns_alias_id`, `custom_options`, `created_at`, `updated_at`) VALUES
(99,	'appname',	'/var/hda/web-apps/appname',	'HTML',	'',	'9999-appname.conf',	0,	0,	99,	NULL,	'2013-11-17 12:00:00',	'2013-11-17 12:00:00')" | mysql -uroot -phda hda_production
  • Create a test file
vi /var/hda/web-apps/appname/html/index.html
Insert the text below
<!DOCTYPE html>
<html>
<body>

<h1>Web App TEST Page</h1>

<p>It works!</p>

</body>
</html>
Set the correct permissions on the file
chown apache:users /var/hda/web-apps/appname/html/index.html
  • Test your new web app by entering http://appname in your browser. If all goes well, you should see the test page.


If you have problems, retrace your steps. Ensure you replaced all occurrences of appname accordingly and the id field in both tables match.
Retrieved from "https://wiki.amahi.org/index.php?title=Amahi_7_Create_Manual_Web_App&oldid=74138"