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.

Prerequisites

We’re using PHP in the stable version 7.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '7.1'
[isabell@stardust ~]$

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 informations 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 adress (email sender if you send e.g. invoices), an admin email adress 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:

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 wizzard which you can find in the Akaunting web interface.

Warning

Please note that third-party apps (plugins) need to be updated seperately. 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>