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?

For a desktop session, no AxonOS installation is required: start in a modern browser at app.axonos.io with an Ethereum wallet. SSH-only sessions use your existing SSH client and the command AxonOS generates. 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 supported ETH/USDC flows (up to 25%), or pay directly in AXGT for the hosted service's currently configured 25% flat payment bonus. That bonus is operator-configurable and direct AXGT payments do not also receive a holder tier. 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 for a bounded period. Keep the transaction hash. If polling stops or the page was interrupted, reopen or refresh the payment flow and paste the hash into Credit deposit. Rechecking is safe because a transaction can be credited only once.

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 wasn't my GPU claim started?

Not enough GPUs were free for your profile. Current claims return a capacity result immediately; choose a smaller profile or retry after capacity is released.

Where do I find the SSH command?

Enable SSH in the launch wizard and provide your public key. After launch, the session card displays the complete command with the assigned port. On the hosted service, axonconsole.io is the SSH hostname—not a webpage. Copy the displayed command because the port is not fixed.

How do I reconnect or stop billing?

Reconnect to an active detached session from its session card. Detach leaves the session running and billing continues; End session releases the GPUs and stops compute billing. Closing an SSH connection alone does not end an SSH-only session.

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.

Is there a free trial?

There is no general public free trial. An operator may enable limited wallet-free, invite-only guest demos, but they are controlled access, unavailable on many deployments, and not a public free tier.

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.