Skip to Content
Coinio

Troubleshooting

Common problems and how to fix them.

Start with the logs; Coinio writes everything there:

docker logs coinio

Port 8080 is already in use

docker run fails with Bind for 0.0.0.0:8080 failed: port is already allocated. Publish another host port and keep the container port:

docker run -d --name coinio --restart unless-stopped \
  -p 9000:8080 -v coinio-data:/data \
  ghcr.io/yakupemreyerli/coinio:latest

Coinio is then at http://<server-ip>:9000. With Compose, change "8080:8080" to "9000:8080".

The container stops with SQLITE_CANTOPEN

The app cannot write to /data. On start it takes over a root-owned data folder by itself, so this usually means something else blocks it:

  • On SELinux hosts (Fedora, RHEL), a bind-mounted folder needs the :Z flag, for example ./data:/data:Z.
  • The folder sits on a network share or read-only disk that does not allow changing the owner. Use a named volume (-v coinio-data:/data) or a local folder.

Remote MCP clients cannot sign in

The log shows COINIO_PUBLIC_URL is not https: OAuth for remote MCP clients is disabled. Set COINIO_PUBLIC_URL to your https address (see Expose to the internet) and recreate the container. API keys work either way.

Exchange rates are missing or old

The dashboard says rates are not up to date, or some subscriptions are "not in the total (no exchange rate)".

  • Check that the server can reach the rates service: docker exec coinio wget -qO- "https://api.frankfurter.dev/v1/latest?from=USD&to=EUR".
  • Look for fx: refresh ... failed lines in the logs.
  • The currency may not be in the ECB's list. Those subscriptions stay out of totals until a rate exists. See Currencies.

Coinio retries on its own; there is nothing to restart.

The widget or claude.ai cannot connect

  • Both need Coinio on a public https address. A LAN address or plain http does not work from outside. See Expose to the internet.
  • claude.ai and ChatGPT also need COINIO_PUBLIC_URL set to that address. If the log shows COINIO_PUBLIC_URL is not set: OAuth for remote MCP clients is disabled, OAuth is off.
  • Open https://<your-address>/api/health from your phone's mobile data. If it does not load, the problem is the tunnel or proxy, not Coinio.
  • For the widget, check the key: curl -H "Authorization: Bearer <key>" https://<your-address>/api/widget must return JSON, not invalid_token.

Telegram messages do not arrive

  • Click Send test message in Settings › Notifications. "Telegram did not accept the message" means the token or chat ID is wrong.
  • Send your bot a message first; bots cannot start a conversation.
  • Environment variables override the app: if COINIO_TELEGRAM_BOT_TOKEN is set, the token in the app is ignored.
  • The daily message is skipped on days with nothing to report.

Too many login attempts

After 10 failed logins from one IP address within 15 minutes, logins are refused for a while. Wait 15 minutes. Successful logins do not count.

I forgot my password

There is no reset email: Coinio has no mail server and only one account. Set a new password from the server with the libraries already in the image. Replace the password (at least 10 characters) and run:

docker exec -e NEW_PASSWORD='your new password' coinio node --input-type=module -e "
import Database from 'better-sqlite3';
import { hash } from '@node-rs/argon2';
const db = new Database('/data/coinio.db');
const { changes } = db.prepare('UPDATE users SET password_hash = ?').run(await hash(process.env.NEW_PASSWORD));
db.prepare('DELETE FROM sessions').run();
console.log(changes ? 'Password changed.' : 'No account found.');
"

This also signs out every device. Your username stays the same.

Edit on GitHub

On this page