From Amahi Wiki
Jump to: navigation, search

Webapps are your custom web applications, local to your HDA. The power of LAMP at your fingertips, right in your home server. They could be your own code or a customized version of an existing app.

See the screencast on how to use webapps.

NOTE: the screencast is slightly outdated - the webapps are no longer in their own tab - they are under Applications -> Webapps (Amahi 6), and Advanced settings must be enabled for them to show. The Amahi Web Apps application provides this functionality for Amahi 7 or greater.

Creating a webapp creates a root directory (gives you the choice to change it) and a short, local dns name to conveniently access that app.

Once done, you simply proceed to the html dir of the app and install the app as directed by the authors of the app.

You have to create your own app database if any directly with mysql.

However, we provide a little script called

hda-create-db-and-user dbname

which creates a database called dbname and a corresponding user name for it matching (the password is also the DB and user name). Run hda-create-db-and-user -h for help on customizing the username and password as well as dropping the db and user.

Once the htmp/php/python/perl/ruby files are installed, the app should be ready to go at the url for it!


  • The root directory as far as Apache is concerned is really the html/ directory. However, in Amahi we create a "base directory" with html/ and logs/*
  • The "base dir" that Amahi creates is owned by user apache by default, so you may want to change the permissions so that other users can create and edit files in that area:
cd /var/hda/web-apps/yourwebapp
chown -R youruser:users html
  • Some people find it useful to create a new share pointing to the webapp root directory to be able to easily edit their files from their client computer(s) in their favorite editor.


Hosting a Website