FAQ & Troubleshooting

Common questions, hosted platform first. If something here doesn't cover your case, open an issue on GitHub.

Using app.axonos.io

Do I need to install anything?

No. AxonOS runs entirely in your browser at app.axonos.io. You only need a modern browser and an Ethereum wallet. See Launch AxonOS.

Do I need an account?

No — your wallet is your identity. You sign a free, one-time message to prove ownership; there's no email or password. See Connect your wallet.

Does signing the challenge cost gas or move funds?

No. It's a personal_sign message signed locally in your wallet — not a transaction. It only proves the address is yours.

I connected but my balance is 0

That's expected before your first deposit. Add credits via Buy compute credits; you need credit to launch a session.

Credits & billing

How does pricing work?

You buy prepaid credits measured in minutes. Active sessions deduct minutes via a heartbeat, weighted by your GPU profile. Pay in ETH (with an AXGT-holder discount), USDC, or AXGT. See Pricing & AXGT.

Do credits expire?

No — unused minutes persist between sessions.

How do I pay less?

Hold AXGT for a tiered discount on ETH payments (up to 25%), or pay directly in AXGT for a value bonus. See Pricing & AXGT.

My deposit hasn't credited yet

Deposits credit after enough block confirmations (6 by default). The page shows the transaction as pending and polls automatically — just wait a few minutes.

Sessions

Which GPU profile should I pick?

The smallest that fits your work: Small (1 GPU) for notebooks/analysis up to Max (8 GPUs) for heavy training. Cost scales with GPU count. See Launch a GPU session.

Why am I in a queue?

Not enough GPUs were free for your profile. The queue is fair and schedulability-aware; your session starts automatically when GPUs free up.

What happens when I run out of credit?

Billing stops and your desktop stays up for a grace period (≈2 hours) so you can top up. After that it shuts down but your files are saved — top up and relaunch to resume.

Files & data

Does my work survive between sessions?

Yes — your home folder is on a persistent volume that's remounted next time. Keep files under your home directory. See Files & persistent storage.

Could my data be deleted?

If you stay offline long enough that storage charges push your balance below the debt limit (≈ −24h of compute), the volume is pruned. Keep a small buffer or move important data off-platform.

How do I get data in and out?

Use the in-desktop browser/terminal, or the bundled IPFS and Syncthing tools. See Files & persistent storage.

Self-hosting

How do I open a self-hosted desktop?

Browse to http://localhost:6080/vnc.html and log in with the VNC password you set at build time. See Quick Start (Docker).

I forgot / didn't set a password

The build-time default is axonpassword (development only). Rebuild with --build-arg PASSWORD="$AXONOS_VNC_PASSWORD". See Security.

GPU isn't detected

Confirm the NVIDIA Container Toolkit is installed and that docker run --gpus all … nvidia-smi works. On GPU hosts, pin NVIDIA_DRIVER_PKG_VERSION to your host driver. See System Requirements.

docker compose down -v wiped my data

-v removes the Postgres volume (the credit ledger). Use docker compose down without -v for normal restarts. See Docker Compose.

How do I add a tool that isn't included?

Use the plugin system — a YAML/JSON definition or the GUI template builder. See Extending AxonOS.