FAQ
Where is my data?
Section titled “Where is my data?”In the data folder you chose on first launch (it suggests ~/ilearnassist). The control panel shows
that path and has a button to reveal it in your file manager.
Inside:
db/sqlite/ilearnassist.sqlite— the databaseusers/<name>/workspaces/— workspaces and their filesusers/<name>/sources/— your uploads
How do I back it up?
Section titled “How do I back it up?”Copy that folder. That is the whole backup; the application itself can be reinstalled freely.
Inside it, <data folder>/backups/ holds the snapshots taken automatically before a database
upgrade (the most recent five). When the schema has to change, the app copies the database first,
because an upgrade that succeeds and turns out to be wrong has no other way back.
I forgot my password
Section titled “I forgot my password”Use Reset administrator password in the desktop control panel. It works with the server stopped — a forgotten password is usually discovered at the same moment as something else being wrong, so recovery cannot depend on a service that may be the thing that is broken.
From a source checkout:
pnpm --filter @ilearnassist/server cli reset-admin --username <you> --password-stdinFor safety, a superadmin’s own password can only be reset this way, never from the web console.
Why is the model list empty?
Section titled “Why is the model list empty?”No API key is configured. Set one in Platform console → Model services and it appears in the model picker immediately. See Model providers.
Can I use it from my phone?
Section titled “Can I use it from my phone?”Yes. The control panel has a LAN sharing switch; turning it on shows a QR code that a phone on the same Wi-Fi can scan.
Does uninstalling delete my data?
Section titled “Does uninstalling delete my data?”No. The program and your data are in different places, and uninstalling the app leaves the data folder untouched. Delete that folder by hand to remove everything.
How do I upgrade?
Section titled “How do I upgrade?”The database upgrades itself — there is nothing to do. A newer build walks the schema forward
the first time it starts, and takes a snapshot into <data folder>/backups/ before it touches
anything. The panel says so: “the database was upgraded from vX to vY”, with the path of the copy.
The app itself is a download you install over the old one. The panel tells you when a newer release exists and takes you to the download page; installing over the top leaves your data alone, because your data is not in the app.
There is deliberately no one-click self-update — see Download and install for why.
Which systems are supported?
Section titled “Which systems are supported?”macOS (Apple silicon and Intel), Windows and Linux all have installers, and the source runs anywhere with Node.js 20+.