Ontrack is a simple yet powerful self-hosted budgeting software for Linux. It works by creating a clean and beautiful interface where you can list your budget, review your finances, and even track your spending history. This article shows you how to install Ontrack on Ubuntu Linux 22.04 using Docker Compose and Caddy.
Assumption: This article assumes that you’re installing Ontrack on an Ubuntu LTS VPS with at least 2GB of RAM. It also assumes that your machine is accessible over the internet and that you own a domain name.
Obtaining the Dependencies for Ontrack
The first step in installing Ontrack budgeting software in Linux is to obtain Docker and Caddy. The former will run the entire web app in an isolated container, while the latter will allow you to broadcast it to the internet.
To start, fetch the signing key for the Docker repository from the developer’s website:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpgCreate a new apt repository file for Docker:
sudo nano /etc/apt/sources.list.d/docker.listWrite the following line of code inside your repository file:
deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu jammy stableDownload the signing key for the Caddy project repository:
curl -fsSL 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpgFetch the Caddy project’s repository file by running the following command:
curl -fsSL 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy.listApply your new repositories and make sure that your system is completely up-to-date:
sudo apt update && sudo apt upgradeInstall Docker, Docker Compose, and Caddy using apt:
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin caddy gitGood to know: learn how you can fix broken packages in Linux.
Obtaining the Ontrack Docker Container
Fetch the current Ontrack repository for Linux from the developer’s Github page:
git clone https://github.com/inoda/ontrack.git && cd ./ontrackRun the following command twice to generate two long random strings of text:
cat /dev/urandom | tr -dc 'A-Za-z0-9' | fold -w 32 | head -n 1 >> ~/random-pass.txt
Open Ontrack’s “docker-compose.yml” file using your favorite text editor:
nano ./docker-compose.ymlScroll to the “SECRET_KEY_BASE” variable and change the value from “super-secret” to your first random string.
Replace the “secret” string on the “DATABASE_URL” variable with your second random string.
Scroll down to the “POSTGRES_PASSWORD” variable and replace the “secret” value with your second random string.
Updating and Building the Ontrack Container
Open the Dockerfile for Ontrack using your favorite text editor:
nano ./DockerfileReplace the value of the FROM variable with the following:
FROM ruby:3.1.2-alpine
Save your modified Dockerfile, then open the “package.json” file:
nano ./package.jsonFind the line that starts with @babel/preset-env, then insert the following code underneath it:
"babel-plugin-macros": "^3.0.1",
Scroll down to the “devDependencies” category, then add the following under the @babel/eslint-parser line:
"@babel/plugin-proposal-object-rest-spread": "^7.15.4",
Open your instance’s configuration file using your favorite text editor:
nano ~/ontrack/config/environments/development.rbAdd the following line of code just below Rails.application.configure do:
config.hosts = [
"SUBDOMAIN.YOUR-ROOT.DOMAIN"
]
Save your instance’s config file, then run the following command to build both Ontrack and its Postgres database:
sudo docker compose up --detachNote: The build process for the Ontrack Docker container can take between 5 to 10 minutes depending on your server’s resources. If your machine has less than 2GB of RAM and no swapfile, Docker will fail without reporting any errors on the terminal.
Confirm that the Ontrack containers are running properly by listing all the active Docker processes:
sudo docker ps
Creating an SSL Reverse Proxy with Caddy
At this point, you have a running Ontrack budgeting software on your machine’s port 3000. To access this securely, you need to create an SSL reverse proxy that encrypts the connection between you and your server.
Go to your domain’s DNS manager, then add a new “A” record for your Ontrack instance.
Backup the original Caddyfile, then create a new Caddyfile under “/etc/caddy/”:
sudo mv /etc/caddy/Caddyfile ~/Caddyfile.backup
sudo nano /etc/caddy/CaddyfilePaste the following block of code inside your new Caddyfile:
SUBDOMAIN.YOUR-ROOT.DOMAIN {
reverse_proxy :3000
}Save your new Caddyfile, then start the Caddy daemon to run your new reverse proxy:
sudo systemctl enable --now caddy.serviceTest if your SSL reverse proxy is working by navigating to your URL.
Good to know: learn more about SSL and how it protects the web from malicious actors by issuing your own self-signed certificate in OpenSSL.
Using Ontrack and Creating a User Account
With Ontrack up and running, you can now create your user account. To do this, go back to your server’s terminal window then open the shell for the Ontrack container:
sudo docker exec -it ontrack shOpen the database handler inside your Ontrack container:
bundle exec rails cCreate your new user account by running the following command:
User.create!(username: "YOUR-USERNAME", password: "YOUR-SECURE-PASSWORD")
Type “exit”, then press Enter to leave the database handler.
Press Ctrl + D to leave your Docker container’s root shell.
Test your new account by opening Ontrack on your web browser and logging in to your account.
Creating Your First Transaction on Ontrack
To use Ontrack for logging transactions, you need to create an expense category. This allows the web app to collate your expenses in groups, which makes it easier to infer insights into your spending habits.
Scroll down the Ontrack dashboard, then click Add a category.
Provide the category’s name, the tag color, and whether or not it has a spending limit. For instance, I’ve labeled mine as “Leisure” with a red tag and a limit of $200.
Click Add an expense on the Ontrack Dashboard.
Fill in the details of your expense, then click Save to commit it to your Ontrack instance.
Lastly, confirm that Ontrack has successfully saved your transaction by checking your expense history. To do that, scroll up the page, then click the History link on the page’s upper right corner.
Installing and deploying your own expense tracker software is just the first step in taking back control over your online and digital life. Learn how you can ensure your privacy when sending emails by installing an alias server like SimpleLogin.
Image credit: Campaign Creators via Unsplash and Ontrack Github. All alterations and screenshots by Ramces Red.
One comment
Personal finance has been my one disappointment with Linux. I have not found a suitable Quicken alternative. They seem to be full fledged accounting software which is overkill for me, or way to simple. I also don’t want a text box, but direct entry into my ledger. The best alternative I have found is GnuCash, but again it is way more complex than I need.