Akaunting¶

Akaunting is a free, open source accounting software designed for small businesses and freelancers. With features like invoicing, expense tracking and accounting it can be used to manage money online while retaining full data ownership.

The software is based on top of the Laravel framework and therefore written in PHP.

Note

For this guide you should be familiar with the basic concepts of

License¶

Akaunting is released under the GPLv3 license. The licence can be found in the GitHub repository. Please also regard the Akaunting terms.

https://github.com/akaunting/akaunting/blob/master/LICENSE.txt

https://akaunting.com/terms

Prerequisites¶

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
--default-character-set=utf8mb4
--user=isabell
--password=MySuperSecretPassword
[isabell@stardust ~]$

Your domain needs to be set up:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation¶

cd to your DocumentRoot and download the latest release, then unzip it into the html directory:

[isabell@stardust ~]$ cd /var/www/virtual/$USER/
[isabell@stardust isabell]$ wget --output-document=latest.zip https://akaunting.com/download.php?version=latest
--2018-10-09 10:23:04--  https://akaunting.com/download.php?version=latest
Resolving akaunting.com (akaunting.com)... 139.162.160.225
[…]
[isabell@stardust isabell]$ unzip latest.zip -d html
[…]
inflating: html/routes/api.php
inflating: html/routes/channels.php
[isabell@stardust ~]$

Configuration¶

Point your browser to your domain (e.g. isabell.uber.space) to set up and configure your Akaunting installation.

Step 1: Language Selection¶

Choose your desired language.

Step 2: Database Setup¶

Akaunting saves your data in a MySQL database. We suggest you use an additional database. You need to create this database before you enter the database credentials in the installer.

[isabell@stardust ~]$ mysql -e "CREATE  DATABASE ${USER}_akaunting"
[isabell@stardust ~]$

Enter the following information into the installer:

your MySQL hostname, username and password: the hostname is localhost and you should know your MySQL credentials by now. If you don’t, start reading again at the top.

the name of your newly created Akaunting database (e.g. isabell_akaunting)

Step 3: Company and Admin Details¶

Fill in the name of your company, the company email address (email sender if you send e.g. invoices), an admin email address and your admin password.

That’s it. After the installation you can login with your chosen admin credentials.

Usage¶

There is a user manual available which describes the interface, concepts and workflows:

https://akaunting.com/docs

Updates¶

Note

Check the update feed regularly to stay informed about the newest version.

You will be additionally notified about available updates in the built in notification center. You can update the installation in the update wizard which you can find in the Akaunting web interface.

Warning

Please note that third-party apps (plugins) need to be updated separately. Available app updates are listed directly under the core updates. Make sure to check these regularly.

Tested with Akaunting 1.2.16, Uberspace 7.1.13

Written by: Daniel Kratz <https://danielkratz.com>