Troubleshooting
Common client issues when buying and managing VMs
Symptom-first fixes for the path in Get started.
Client org required
Symptoms: Dialog asking you to switch to a client organization when launching from the marketplace, or create flow blocked.
Marketplace purchases are client-only. Provider organizations sell infrastructure; they do not buy from the marketplace in the same org.
Switch organization
Use the organization switcher and select a Client org.
Create a client org
If you only have a provider org, Create organization → Client → retry launch at /platform/virtual-machines/create.
Payment method
Symptoms: VM create fails with payment validation error; billing banner warns about missing payment method.
Add a payment method
Open /billing?t=payment-methods and attach a card through Stripe.
Set default
Ensure one method is marked default. VM create uses the default payment method.
Retry launch
Return to /platform/virtual-machines/create and submit again.
More detail: Billing.
Provisioning
Symptoms: VM stays in provisioning or pending for a long time; never reaches running.
Provisioning runs on the provider's infrastructure. NodeRings sends the order; the provider's operator clones the template and applies cloud-init.
Wait a few minutes
First boot after clone can take several minutes depending on image and provider load.
Check VM detail
Open the VM → Overview for status messages or assigned IPs. If IPs are missing, the provider may still be assigning from their IPAM pool.
Open a ticket
If status does not change after 15–30 minutes, open a ticket linked to the VM and contact the provider.
Cannot connect (SSH)
Symptoms: Connection timeout or refused when SSHing to the VM IP.
Confirm the VM is running
On the VM detail page, Start the instance if it is stopped.
Match auth method
If you chose SSH keys at launch, use the private key that matches a key you selected. If you chose password, use root (or the user your cloud-init defines) with the password you set.
Check firewall
If you attached a restrictive firewall ruleset, ensure SSH (tcp/22) is allowed from your source IP.
More detail: Virtual machines → Connect.
VNC console blank or disconnected
Symptoms: Browser console loads but shows no display, or disconnects immediately.
- Confirm the VM is running.
- Console traffic is relayed through the provider's network: transient drops can happen; refresh and reconnect.
- Some images need a first boot to complete before the display is active; wait and retry.
- On VirtFusion, the last hop is classic RFB on the hypervisor (often TCP 5900–5999). If the console fails, the provider agent cannot reach that VNC port. This is not an invalid Proxmox ticket.
- On SolusVM 2, the last hop is the management-node websocket (
wss://…/vnc). If the console fails, the agent cannot reach the SolusVM 2 management node on HTTPS 443. This is not an invalid Proxmox ticket.
More detail: Virtual machines → VNC console.
Invite not working
Symptoms: Invite link expired or organization not visible after accept.
Accept while signed in
Open the invite link logged in as the invited user, or sign up first then accept from /profile?t=invites.
Resend
Ask an org admin to resend from /organization/members?t=invites.
More detail: Organization.
Domain not using NodeRings DNS
Symptoms: Website or mail still hits the old host; zone stays Pending nameservers; Waiting for NS on the Nameservers tab.
Confirm nameservers at the registrar
The parent must list only ans1.nrings.io and ans2.nrings.io. Mixed NS with the previous host will not complete delegation. See DNS → Nameservers.
Check in NodeRings
Open the zone → Nameservers → I've updated nameservers. When the parent matches, the badge is Delegation verified and the zone is Active.
DNSSEC from a previous host
If you still have DS at the registrar from another DNS provider, remove it before changing nameservers, or validating resolvers can SERVFAIL. See DNSSEC.
Related
- How it works: marketplace and billing overview
- DNS: hosted DNS, GeoDNS, and DNSSEC
- Provider Guides: if you also operate infrastructure as a seller