= Install =
[[TracNav(TracNav/TOC)]]

== Overview ==

In order to run DomotiGa you need a working Gambas 2.x environment.
With the current DomotiGa code you need at least version 2.13.1 (install it from the svn repository)
Look [wiki:Gambas/Install here] how to install it on your system.

== Installation of DomotiGa ==

Login as the user you want to run DomotiGa as, Do not use root! It's a security risk!
Then create an installation directory in your home directroy and download a the latest release of DomotiGa with svn.

{{{
$ mkdir -p  ~/install
$ cd ~/install

$ svn co http://svn.domotiga.nl/domotiga/trunk/ domotiga
}}}

This will create a new directory called 'domotiga' with all code in it.

Copy these files over to your home dir and work from there, otherwise an update of the svn will overwrite your files.
{{{
$ cp -rp ~/install/domotiga ~
}}}

== Create DomotiGa Database ==

You need to create and import the example database, for this you need your mysql root password.

Note: Ubuntu/Debian asks for this password when you are installing mysql-server package, so you can skip this step.
'''Configure your MySQL Install:'''

If this is the first time you use a MySQL database on this machine, please set a MySQL root account password first:

{{{
$ mysqladmin -u root password "yourpassword" (without quotes)
}}}


DomotiGa uses a default database name, username and password as supplied in domotiga.sql, if you want to use different ones
you need to edit the file domotiga.conf before starting the program.

Next import the Domotiga example database:

{{{
$ mysql -u root -p <~/domotiga/install/domotiga.sql
}}}

Now you can start Gambas2 IDE and Open Project, browse to ~/domotiga/DomotiGa and open it.
Start the project to run DomotiGa.

You can also create a shortcut/launcher which starts DomotiGa directly.
See the README inside the domotiga directory.

(you have to compile/create executable of the project first if you have made changes to the source code)

''HAVE FUN''!