Install & Launch AFT
You only need Docker Desktop. No coding tools or manual database setup required.
Your plain-language handbook—from installing the app on your computer and logging in for the first time, to tracking funds, speeding up a sluggish app, and recovering a forgotten password without losing a single record.
You only need Docker Desktop. No coding tools or manual database setup required.
Lag does not mean your data is broken. Learn the safe 1-minute ways to make AFT snappy again.
Generate a ready-to-paste command to reset your password without wiping any records.
ANINAW runs right on your laptop or desktop inside Docker Desktop. Follow the tab for your computer below.
Download and install Docker Desktop for Windows from docs.docker.com/desktop. Open Docker Desktop and wait until the bottom-left / tray icon turns green (running).
Open the AFT project folder, open the scripts folder, and double-click install_windows.bat. (If Windows asks for Administrator permission, click Yes.) If your computer needs a restart to finish WSL/Docker setup, restart and let it resume automatically.
Wait 2–5 minutes on the very first launch while Docker downloads the app files. Your browser will open automatically, or you can visit http://localhost:5173 (or use the new Automated Fund Tracker shortcut on your Desktop).
Open the AFT project folder, open scripts, and double-click install_mac.command. It automatically checks for Homebrew and Docker Desktop, installs them if missing, and starts Docker.
If macOS asks for your Mac password or permission, approve it. Wait a few minutes on the first run for the app containers to finish setting up.
Your browser will open http://localhost:5173 automatically (and a shortcut is saved on your Desktop).
Make sure Docker Engine + Docker Compose are installed, then run the setup script inside the project folder:
chmod +x scripts/install_linux.sh && ./scripts/install_linux.sh
Visit http://localhost:5173 once the containers finish starting.
If your organization received only a single docker-compose.yml (or docker-compose.prod.yml) file:
AFT-System).docker compose up -d
Next time you turn on your computer, open Docker Desktop (or click Start on the project inside Docker Desktop) and go to http://localhost:5173.
Your database lives in data/postgres/ (or Docker’s pgdata volume), receipts & logos live in data/uploads/, and a live Excel-ready log stays updated in data/reports/transactions_log.csv. Never delete the data/ folder unless you want to erase everything!
When you open ANINAW for the first time, sign in using the default administrator account, then change the password right away.
Multi-organization setup? Your platform administrator signs in with superadmin / superadmin123 (and creates each org’s own Admin account from the Superadmin portal).
Go to Settings → Security, click Change Password, and save a password your officers will remember (write it in your org handover notebook or password manager!).
Go to Settings → Organization, fill in your Organization Name and Acronym, upload a logo (PNG/JPG/WebP under 5MB), and click Save Changes. This logo appears on your printed PDF reports.
Go to Settings → User Management and click Add User so each officer has their own username and role instead of sharing the admin login.
If your organization already has starting cash from last semester, open Ledger → Other Assets and click Establish Beginning Balance.
Follow this simple order whenever your organization runs events, handles money, or prepares financial statements.
Full control of the organization workspace. Can manage settings, add/remove users, reset forgotten passwords for Treasurers/Auditors, view Audit Logs, and record transactions.
Day-to-day finance operator. Creates events, manages accounts, logs transactions with receipts, and updates Supplies, PPE, and Inventory ledgers.
Read-only reviewer. All add/edit/delete forms are hidden so records stay safe. Can inspect reports, receipts, Audit Logs, and Transaction Edit History.
Your homepage automatically calculates Cash on Hand, Cash in Accounting, total income/expenses, budget utilization, and liquidation reminders. You never type directly into the summary boxes.
1010 Cash on Hand or 4010 Food Expense. Add custom ones with Add New Account.Click New Entry and pick one of the 5 transaction modes:
Receipt rule: Attach a clear PNG, JPG, or PDF receipt (max 5MB). Made a mistake? Use Void or Edit so the audit trail stays intact.
Go to Financial Reports, choose your date range, and view the Statement of Assets and Liabilities, Statement of Activities, or Statement of Cash Flows. Click Export CSV or Download PDF anytime—and remember that data/reports/transactions_log.csv inside your project folder also updates live for Excel!
If pages are taking too long to load or buttons feel sluggish, try these simple, non-technical steps in order. None of these steps will delete your records.
A slow screen almost always means your computer is temporarily busy or out of memory—it does not mean your database is corrupted or your data is lost.
Just like a phone or browser, restarting the app clears temporary sluggishness while keeping every transaction and receipt untouched.
Open the Docker Desktop window from your taskbar or menu bar.
Find your AFT stack (aft_backend, aft_db, aft_frontend) and click the Stop button.
Wait 10 seconds, click Start, wait until all icons are green, then refresh http://localhost:5173.
High-resolution phone photos or multi-page scanner PDFs can be huge (4–5MB each), which slows down uploading and viewing receipts over time.
Tip: Send/compress receipt photos (for example via Messenger/compressed photo or a clean screenshot) so they stay clear to read without taking up several megabytes per file.
data/ folder or Docker volumes: That deletes your database and receipts!Which account is locked out? Choose the matching option below.
Ask anyone with an ADMIN login on your team to sign in to ANINAW.
Open Settings → User Management.
Click the Key icon (Reset Password) next to your username and enter a new password. Done!
admin Account
First, try the default password admin123 in case it was never changed. If that says Invalid credentials, use the One-Command Rescue Tool below—it updates only the password and keeps 100% of your records safe.
Type your new password below, copy the generated command, and run it once.
docker exec -e NEW_PASS='YourNewPassword' aft_backend node -e 'const bcrypt=require("bcrypt"),{PrismaClient}=require("@prisma/client"),p=new PrismaClient();bcrypt.hash(process.env.NEW_PASS,10).then(h=>p.user.update({where:{username:"admin"},data:{passwordHash:h}})).then(u=>console.log("Updated password for:",u.username)).finally(()=>p.$disconnect())'
If using a “Running” option, check Docker Desktop and make sure aft_backend and aft_db are green/running.
On Windows, press the Windows key, type PowerShell (or cmd if you picked Windows CMD), and press Enter. On Mac, open Terminal. Right-click to paste the command and press Enter.
When you see Updated password for: admin, refresh http://localhost:5173 and log in with your new password!
No. All transactions, accounts, events, receipts, and users are saved inside your local data/ folder (or Docker’s pgdata volume). Restarting Docker Desktop or running the one-line password reset only changes that user’s password—nothing else is touched.
Someone already changed the admin password after the first setup, or you are signing in to a newly created organization whose admin username/password was set by the Superadmin. Restarting the app keeps your changed password, so use the Password Reset Command Builder above to set a fresh password.
If your school or council uses the multi-organization version of AFT, the platform Superadmin can temporarily enable or disable an organization’s access. Contact your Superadmin so they can toggle your organization back to ACTIVE.
Yes! Two ways:
data/reports/transactions_log.csv directly in Excel—it stays updated automatically as transactions are recorded.Open Journal, find the entry using the search bar, and click Edit or Void. ANINAW keeps an audit history of edits and voids so your Auditor can verify every change cleanly.
Just close your browser tab, or open Docker Desktop and click Stop on your AFT containers (or run docker compose down inside your AFT folder). Your data stays saved safely on your computer for next time.