Self-hosted server¶
If you have your own (virtual) web server you can use this guide to install Firefly III. You may have some ingredients prepared already.
Ingredients¶
You need a working LAMP, LEMP or WAMP stack. If you don’t have one, search the web to find out how to get one. Make sure you’re running PHP 7.2. There are many tutorials that will help you install one. Here are some Google queries to help you.
If you wish to use another database such as SQLite or Postgres, please check out the Server FAQ.
You need a (MySQL) database and credentials for a user that can access that database. Firefly III creates its own tables. Avoid using the root user.
Several users have created specific guides for their OS and database combination
- CentOS 7, with nginx and PHP 7.2
- Ubuntu Server 16.04LTS with nginx and PHP 7.2
- Ubuntu Server 18.04 with nginx and PHP 7.2
In case you want to use one of the languages that Firefly III is equipped with, make sure you have installed the necessary locales. For Debian / Ubuntu for example, use sudo apt install language-pack-nl-base && sudo locale-gen
.
Preparing your server¶
Extra packages¶
Install the following PHP modules:
- PHP BCMath Arbitrary Precision Mathematics
- PHP Internationalization extension
- PHP Curl
- PHP Zip
- PHP GD
- PHP XML
- PHP MBString
- PHP LDAP
You can search the web to find out how to install these modules. Some may be installed already depending on your system. Use phpinfo()
to find out.
Installing composer¶
If you have sudo rights (try sudo ls
) you can install composer using the following command:
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
Verify the installation of composer using the following command.
composer -v
If you have no sudo rights, you can simply download composer with the instructions under the header “manual download”. Use php composer.phar
instead of composer
in the instructions ahead.
This concludes the server preparations. If you’re having trouble with (parts of) this step, please check out the Server FAQ.
Installing Firefly III¶
Main command¶
Browse to /var/www
which is probably the directory where your web server is configured to find its files.
Enter the following command.
composer create-project grumpydictator/firefly-iii --no-dev --prefer-dist firefly-iii <latest>
You should replace <latest>
with the latest version, which you can find on the Github release list.
If this gives an error because of access rights, prepend the command with sudo
. Then fix the access rights:
sudo chown -R www-data:www-data firefly-iii
sudo chmod -R 775 firefly-iii/storage
Configuration¶
In the firefly-iii
directory you will find a .env file. Open this file using your favorite editor. There are instructions what to do in this file.
Initialize the database¶
This step is very important, because Firefly III needs a database to work with and it will tell you whether or not your configuration is correct. Run the following command in the Firefly III directory.
php artisan migrate:refresh --seed
php artisan firefly:upgrade-database
php artisan firefly:verify
php artisan passport:install
Now you should be able to visit http://localhost/firefly-iii/ and see Firefly III.
If you’re having trouble with (parts of) this step, please check out the Server FAQ.
Accessing Firefly III¶
Browsing to site¶
Browsing to the site should be easy. You should see a login screen.
Registering an account¶
You cannot login yet. Click on “Register a new account” and fill in the form.
Your first accounts¶
You will be logged in automatically. Follow the instructions and you are done!
If you’re having trouble with (parts of) this step, please check out the Server FAQ.