Introduction

Athena Alpha is an obsessively private, intuitive and easy to use Finance and Life Management app. Designed to help you better yourself, entirely open source and free to run on any computer, server, NAS or even Raspberry Pi.

Created for privacy minded, everyday people who want to be able to properly manage their finances, plans and other everyday aspects of life in a single application that’s modern, beautiful and above all private. There is no safer way to guard your private information than by fully hosting it yourself. So stop sacrificing your privacy and personal information just to get a confined and sub par experience with existing platforms like Mint. Instead, upgrade to Athena Alpha, take back control and get so much more, for free!

rocket_launch

Installation

Welcome! It’s awesome you want to install Athena Alpha, just choose your OS or device of choice below and let’s do this!

The default account is: Username: athena | Password: themostsecurepasswordever

Linux

Download and install Docker Engine for Ubuntu (or other distro), then confirm it’s working properly via the command-line terminal

sudo snap install dockersudo docker run hello-world

Download and install Docker Compose

sudo apt install docker-compose

Create a new directory to house the app, then go into that new directory

mkdir Athena-Alpha && cd Athena-Alpha

Download the Docker Compose file

wget https://raw.githubusercontent.com/athena-alpha/athena-alpha/main/docker-compose.yml

Build and run the Athena Alpha container in detach mode

docker-compose up --build -d

Browse to https://localhost and you’re good to go!

To stop Athena Alpha

docker-compose down

Database Access

Athena Alpha phpMyAdmin

If you would like to have direct access to the database via phpMyAdmin, simply uncomment the ‘phpmyadmin’ section in the docker-compose.yml file before running ‘docker-compose up –build -d’ coommand. To do this remove the ‘#’ characters at the beginning of each line. Then browse to http://localhost:8000 and you’re good to go!

The default database account is: Username: athena | Password: themostsecurepasswordever

Windows

Download and install Docker Desktop for Windows, then confirm it’s working properly via a command-line terminal like PowerShell

sudo docker run hello-world

Create a new directory to house the app, then go into that new directory

mkdir Athena-Alpha && cd Athena-Alpha

Download the Docker Compose file

wget https://raw.githubusercontent.com/athena-alpha/athena-alpha/main/docker-compose.yml

Build and run the Athena Alpha container in detach mode

docker-compose up --build -d

Browse to https://localhost and you’re good to go!

To stop Athena Alpha

docker-compose down

Database Access

Athena Alpha phpMyAdmin

If you would like to have direct access to the database via phpMyAdmin, simply uncomment the ‘phpmyadmin’ section in the docker-compose.yml file before running ‘docker-compose up –build -d’ coommand. To do this remove the ‘#’ characters at the beginning of each line. Then browse to http://localhost:8000 and you’re good to go!

The default database account is: Username: athena | Password: themostsecurepasswordever

Mac

Download and install Docker Desktop for Mac, then confirm it’s working properly via the command-line terminal

sudo docker run hello-world

Create a new directory to house the app, then go into that new directory

mkdir Athena-Alpha && cd Athena-Alpha

Download the Docker Compose file

wget https://raw.githubusercontent.com/athena-alpha/athena-alpha/main/docker-compose.yml

Build and run the Athena Alpha container in detach mode

docker-compose up --build -d

Browse to https://localhost and you’re good to go!

To stop Athena Alpha

docker-compose down

Database Access

Athena Alpha phpMyAdmin

If you would like to have direct access to the database via phpMyAdmin, simply uncomment the ‘phpmyadmin’ section in the docker-compose.yml file before running ‘docker-compose up –build -d’ coommand. To do this remove the ‘#’ characters at the beginning of each line. Then browse to http://localhost:8000 and you’re good to go!

The default database account is: Username: athena | Password: themostsecurepasswordever

Synology NAS

To setup Athena Alpha on your Synology NAS requires a bit of configuration as you can’t use the Docker Compose file. Instead you need to download and configure each of the 3 Docker images that Athena Alpharuns on.

Download and install Docker via the Package Center in DSM. It should be Running as seen below

Athena Alpha Install Synology NAS Step 1

Once installed, open Docker up, select “Registry” on the left panel and use the search box in the top right hand corner to search for “athenaalpha”

Athena Alpha Install Synology NAS Step 2

Download the latest image files for Athena Alpha by double clicking on all 3 of the results

Athena Alpha Install Synology NAS Step 3

Once the images have been downloaded, they should appear in the “Image” section. Click on each of them and click “Launch” to begin configuration

Athena Alpha Install Synology NAS Step 4

You will have to Launch and configure each of the 3 images in a similar way, but with slightly different advanced settings shown below. Give each of the new containers a name and click on “Advanced Settings” at the bottom left of the setup wizard

Athena Alpha Install Synology NAS Step 5

On all 3 of the images, ensure the “Enable auto-restart” is checked

Athena Alpha Install Synology NAS Step 6-1

You will only need to configure the Volume section for the Database image (athena-alpha-db). Click the “Add Folder” button, then choose where you’d like all the database information to be saved to on your NAS. Then, in the “Mount path” field enter in ‘var/lib/mysql’ as shown

Athena Alpha Install Synology NAS Step 6-3

For all 3 images you will need to enter port configuration under the Port Setting section. Map the Local Port to the Container Port as specified in the table below. For the athena-alpha-client image, you can choose whatever port you wish, or simply map it to 443 (the default https port)

Athena Alpha Install Synology NAS Step 6-2

Finally, click “Apply” to close the Advanced Settings box, click “Next” in the wizard and then “Done” to save everything and also run the container. Once all 3 containers have booted up for the first time, browse to https://Your-Synology-NAS-IP:Your-Port and you’re good to go!

The default database account is: Username: athena | Password: themostsecurepasswordever

file_download

Updating

Coming Soon…

sync

Change Log

For the full change log for all versions (in a nice and neat JSON format), please see here.

Also see the future Road Map and for a full outline of the current features that will be released in the next version (in a nice and neat JSON format), please see here.