phpRechnung - ReadMe


To install phpRechnung 1.6.4 you will need:


Web server:
nginx, Apache, Lighttpd or maybe ( Microsoft IIS - not tested )

PHP version 5 ( mbstring, PEAR::Mail, Mail_Mime is required )

MySQL version 5 or 4 ( Starting from phpRechnung 1.8 also another databases will be supported )

e. g. Postfix, Exim, Sendmail ...


e. g. Firefox, Konqueror, Safari, Opera, Google Chrome ...
( Javascript must be enabled )


Important note:
Under Configuration/Settings please enter a correct E-Mail address,
otherwise you will have problems sending e-mail's.

The configuration file ' ' can be found in the /include directory.

$Smtp["host"] = "yourmailserver";
$Smtp["port"] = "25";
$Smtp["auth"] = false;
$Smtp["username"] = "";
$Smtp["password"] = "";

If your mail server needs authentication, so please change
$Smtp["auth"] = true; and set $Smtp["username"] and $Smtp["password"]

Important note:

Questions to (open_basedir, safe_mode etc.) have nothing to do
with phpInvoice and will not be answered any more.

Unpack phpRechnung_1_6_4.tar.gz - tar zxvf phpRechnung_1_6_4.tar.gz
Copy the directory ' phpRechnung ' to your Web server e. g. /var/www
( or change the name phpRechnung to phpInvoice )


Since phpRechnung 1.6 RC1 Smarty Template engine is used.
Still some changes must be made in order to work.

The Webserver must have write access for following directories
'/include/smarty/cache' and '/include/smarty/templates_c'

It is recommended (but not mandatory) to place these directories
outside of the web server's document root.

The same for these directories '/include/smarty/templates' and '/include/smarty/configs'

You must notify phpRechnung about the changes

In '/include/' change following variable:

$Templateroot and $Cacheroot from $_SERVER['DOCUMENT_ROOT'] ."phpRechnung";

to something like

$smarty->template_dir = "/var/www/include/ smarty/templates";
$smarty->config_dir = "/var/www/include/ smarty/configs";
$smarty->compile_dir = "/var/www/include/ smarty/templates_c";
$smarty->cache_dir = "/var/www/include/ smarty/cache";

More information about Smarty at Link:

Create Database:

mysqladmin -u 'user name' -p create phpinvoice

Create tables:

mysql -u 'user name' -p phpinvoice < phprechnung_1_6_4.sql

If you have no 'root' access, please use 'phpMyAdmin'

First create database, then select the data base, then select Import,
Location of the text file: select suitable file: phprechnung_1_6_4.sql,
then select Character set of the file: 'latin1' and click on Go.

You will see a message something like this:

Import has been successfully finished, 127 queries executed.


Please don't insert the SQL file into the field Run SQL query/queries on database.
The data will be inserted without any errors, but thereafter, a login is no longer possible.

The following files must be changed
in order to access your new database ' phpinvoice '.

In the directory ' /include '

' dbconf.php ' for the data base connection
_DBHOST z. B. "localhost"
_DBUSER z. B. "username"
_DBPASS z. B. "userpassword"
_DBNAME z. B. "phpinvoice"

_DBUSER must have enough rights on your

' '
(importantly is the variable "$web" please enter your own Web address
where you copy phpRechnung_1_6_4 e.g. yourserver/phpInvoice
(without '/' at the end) otherwise the forwarding will not work.

For users who run phpRechnung on a Windows server,
please adapt under Configuration/Settings TMP-Directory

Standard is '/tmp/' in e. g. 'c:\windows\temp\'

Please consider the last backslash. Importantly.
The Web server must have write access for this directory.

On Windows servers please also examine ' session.save_path '

Standard is session.save_path = /tmp
In this case, please change it
in e.g. session.save_path = c:\windows\temp


Administrator: admin, admin

The user data are stored encrypted in the table 'user'

After the first login you will be prompted to accept
the phpRechnung License ( GPL V2 ).

This is needed only once per user.

The administrator password can be changed
only the user name ' admin ' may not be changed.
Otherwise you will not be able to access many sites.

phpRechnung was successfully tested under Debian/Ubuntu Linux Server default PHP configuration.

If you have any comments or suggestions, so please go to the
phpRechnung Forum at

If you wish to subscribe to new releases please go to and register.

Thank you for using phpRechnung

Edy Corak

Frequently Asked Questions - German

Project on
Forum on
phpRechnung Bugs
Support Requests
Mailing Lists

Check availability


Loens Hotel
( Bed & Breakfast )
Hermann-Loens-Strasse 29
30827 Garbsen - Berenbostel, Germany

Telephone: +49 5131 49880

Google Maps OpenStreetMap