Language:
Help Center

Frequently Asked Questions

Everything you need to know about Grapthway VPS โ€” from getting started to billing, tokens, and advanced networking.

9Topics
51Questions
2026-04-22Updated

Getting Started

5 questions

Grapthway is a developer-first Virtual Private Server (VPS) platform built on a decentralized agent network. Instead of a traditional centralised data center, your VPS runs on physical nodes operated by independent node operators who register with the Grapthway network. You get root SSH access, a public IPv4, configurable port ranges, and full control over your server โ€” billed by the month and paid with on-chain tokens.

#overview#platform

Visit the Register page and sign up with your email address and password. After verifying your email you will be redirected to the dashboard. From there you need to create a wallet (Wallet โ†’ Create) before deploying your first VPS โ€” the wallet holds the tokens used to pay for subscriptions.

#account#registration

Three things:

1A verified account โ€” register and confirm your email.
2A wallet โ€” go to Wallet โ†’ Create Wallet to generate your on-chain address.
3A funded wallet โ€” deposit a supported token (e.g. IDRG, USDG) so you have enough balance to cover at least one month of the chosen tier.

Once those are ready, head to VPS โ†’ Deploy and follow the four-step wizard (Tier โ†’ Node โ†’ Configure โ†’ Confirm).

#first-steps#deploy

A tier defines the CPU sharing ratio applied to your VPS. Higher ratios mean more VPS share each physical CPU core โ€” lower ratios mean more dedicated resources.

Student (12:1) โ€” most affordable, ideal for learning, experiments and personal projects.
Shared 6:1 โ€” balanced performance for small apps, staging environments.
Shared 4:1 โ€” reliable for production workloads with moderate traffic.
Shared 2:1 โ€” near-dedicated performance with minimal contention.
Dedicated (1:1) โ€” zero sharing, full dedicated CPU for mission-critical systems.

Choose based on the predictability your application requires and your budget. The product page lets you preview pricing in your preferred token before committing.

#tiers#pricing

Available nodes depend on which operators have joined the Grapthway network. The Node step in the deploy wizard shows all active nodes with their country, city, and available slots in real time. Use the Region, Country, and City dropdowns to filter. New regions appear automatically as operators register โ€” there is no fixed list.

#regions#nodes

VPS Management

9 questions

Deploying a VPS is a four-step wizard:

1Tier โ€” Choose the CPU ratio tier that matches your performance and budget needs. Filter by class, ratio, or accepted currency.
2Node โ€” Select the physical node (location) where your VPS will run. Filter by region, country, and city. Nodes with any resource at zero are automatically hidden.
3Configure โ€” Set your CPU cores, RAM, and disk using the sliders (bounded by node capacity). Choose your billing period (1โ€“36 months). Select your payment token. Configure your SSH port.
4Confirm โ€” Review the summary, set your VPS name and root password, then click Deploy.

The system runs a pre-check before charging your wallet, then triggers the provisioning pipeline. A live log viewer shows provisioning progress.

#deploy#wizard

After provisioning completes (typically 1โ€“3 minutes), your VPS card in the dashboard shows an SSH command:

ssh root@<node-ipv4> -p <your-ssh-port>

Use the root password you set during the deploy confirm step. You can also reset your SSH root password at any time via VPS โ†’ Reset SSH Password without needing to redeploy.

#ssh#access
Running โ€” your VPS is live and accepting connections.
Provisioning โ€” the deployment pipeline is still setting up your server. Wait 2โ€“3 minutes.
Stopped โ€” the VPS process is halted (rare; usually a node issue). Contact support.
Error โ€” provisioning failed. Check the job log for details. You can retry or contact support.
Deleted โ€” the VPS has been removed and resources released.
#status#monitoring

Yes. Open the Scale VPS modal from your VPS card. You can increase CPU, RAM, or disk independently โ€” you do not have to scale all three at once. If a resource is fully exhausted on the node (no headroom), that slider is locked at your current value and shown in red, but you can still scale the other resources that have headroom. A pro-rated charge for the remaining subscription days is deducted from your wallet at the time of scaling.

#scale#upgrade#resources

Yes via Downscale VPS. You can independently reduce CPU, RAM, or disk. Downscaling is free โ€” no additional charge is made. The new lower spec takes effect once the job completes. Note: disk reductions require the OS to release that space first; make sure your data fits the new size before downscaling disk.

#downscale#reduce

Yes. The VPS card shows live CPU and memory usage fetched from the node agent every 15 seconds. Click into your VPS details to see a real-time panel with CPU percentage, memory usage, and disk info. Monitoring is available for running VPS instances only.

#monitoring#metrics

From the VPS card click Delete. A confirmation modal will appear. Once confirmed, the platform sends a termination job to the node agent, which removes the container and releases all resources. Remaining subscription days are not refunded โ€” deletion is permanent. Make sure you have backed up any data you need before deleting.

#delete#terminate

Go to your VPS card โ†’ Reset SSH Password. Enter and confirm your new password (minimum 8 characters). The platform sends a secure password-reset job to the node agent. The new password is effective as soon as the job completes (usually under 30 seconds). You do not need to redeploy your VPS.

#password#ssh#security

Every background operation (deploy, scale, delete, password reset) creates a Job. You can view all your jobs and their detailed log output at Jobs in the sidebar. Log lines from both stdout and stderr are streamed in real time while the job is running. Failed jobs show the error output in red to help you diagnose what went wrong.

#logs#jobs#debugging

Networking & Ports

5 questions

During deployment you choose an SSH host port (1024โ€“65535). The platform checks it live against all occupied ports and port ranges already allocated on that node. If the port is taken, a red indicator appears and you must choose another. This avoids conflicts between VPS instances sharing the same physical node IP.

#ssh#ports#networking

Port ranges let you reserve a block of host ports that are NAT-forwarded to your VPS. Each VPS can reserve up to 1,000 ports total across multiple ranges. To configure them:

1Open your VPS card โ†’ Ports tab.
2Click Add Range and specify a low and high port number.
3Click Save โ€” the platform validates there are no conflicts with other VPS on the same node.

Use these ports to expose services (databases, game servers, custom APIs) through the node's public IPv4 without SSH tunnelling.

#ports#networking#nat

The platform performs a real-time conflict check before accepting any port assignment โ€” both for the SSH port during deploy and for port range bookings in the Ports tab. If a conflict is detected you will see a clear error message identifying the conflicting range. Simply choose a different port or range.

#ports#conflicts

Yes. The Setup Domain modal lets you configure a subdomain (e.g. app.yourdomain.com) that proxies traffic to your VPS. Provide your domain, the internal port your service listens on, and the protocol. The platform creates a proxy rule on the node agent. You must then point your DNS A record to the node's public IPv4 address. TTL changes propagate in 5โ€“60 minutes depending on your DNS provider.

#domain#dns#proxy

Each node has one public IPv4 address that is shared between all VPS running on it. Your VPS is differentiated by its SSH port and any reserved port ranges. If you need traffic isolation, choose a node with low active VPS count, or contact support to discuss dedicated-IP node arrangements.

#ip#networking

Billing & Subscriptions

6 questions

Grapthway uses prepaid monthly subscriptions. When you deploy a VPS you pay upfront for the number of months you selected (1 to 36). The cost is calculated as:

(CPU cores ร— price-per-0.1-core ร— 10) + (RAM ร— price-per-100MB ร— count) + (Disk GB ร— price-per-GB)

All prices are denominated in the token you selected at deploy time. Longer subscriptions may qualify for automatic discounts shown on the pricing page.

#billing#pricing#subscription

Open your VPS card โ†’ Extend Subscription. Select the number of additional months, review the total cost, and confirm. Payment is deducted immediately. Your subscription end date is pushed forward by the chosen duration. You can extend at any time โ€” you do not need to wait until expiry.

#extend#subscription#renew

When a subscription expires the VPS enters a suspended state. The VPS process on the node is halted but data is preserved for a grace period (typically 7 days). During this period you can extend the subscription to bring the VPS back online. After the grace period the VPS is permanently deleted and all data is lost. You will receive email reminders before expiry.

#expiry#suspension#data

When you scale up mid-subscription, you pay the difference in monthly cost pro-rated for the remaining days. The formula is:

pro-rated charge = (new monthly price โˆ’ old monthly price) ร— (days remaining / 30)

This charge is shown in the Scale VPS preview before you confirm. The charge is deducted from your wallet balance in the token associated with your subscription.

#prorated#billing#scale

Yes. Discount programs are available for multi-month subscriptions. The applicable discount is shown automatically in the configurator when you select the billing period. Discounts stack with the base pricing and are applied to the total before payment. Check the product pricing page for the latest discount schedule.

#discounts#savings

The payment token is locked at deploy time and tied to the subscription record. Extension and scaling charges use the same token as the original subscription. To use a different token you would need to deploy a new VPS. This ensures consistent billing across the subscription lifetime.

#currency#token#billing

Wallet & Tokens

7 questions

The Grapthway wallet is an on-chain account address on the Grapthway Protocol network. It holds your token balances (IDRG, USDG, and others) which are used to pay for VPS subscriptions. Your wallet address is generated when you create a wallet inside the platform โ€” it is unique to your account and recorded on-chain.

#wallet#on-chain

The platform supports multiple Grapthway-native tokens pegged to real-world currencies:

IDRG โ€” pegged to Indonesian Rupiah (IDR)
USDG โ€” pegged to US Dollar (USD)
SGDG โ€” pegged to Singapore Dollar (SGD)
EURG โ€” pegged to Euro (EUR)
MYRG โ€” pegged to Malaysian Ringgit (MYR)

Additional tokens may be added over time. Available tokens and their balances are shown in the Wallet section. Not all tokens may be accepted by every tier โ€” check the pricing page to see which currencies each tier supports.

#tokens#currencies#IDRG#USDG

Go to Wallet โ†’ Deposit. Select the token you want to deposit and the amount. Choose your preferred payment method:

QRIS โ€” scan the generated QR code with your mobile banking or e-wallet app.
Virtual Account โ€” transfer to the displayed bank account number.

After payment, upload your proof of payment (screenshot). An admin reviews and approves the deposit, which triggers minting of the equivalent token amount to your on-chain wallet. Approval typically takes a few minutes during business hours.

#deposit#top-up#payment

Grapthway uses a fiat-to-token bridge: real money is received through Midtrans (QRIS or Virtual Account) and an equivalent amount of on-chain tokens is minted to your wallet after verification. The approval step ensures the payment was received and the correct amount is minted. This is a safety check against failed transactions, wrong amounts, or duplicate submissions.

#deposit#approval#verification

Your wallet balance is shown in the Wallet badge in the navigation bar (top right) as well as on the Wallet page Overview tab. Balances for all held tokens are listed. The balance refreshes automatically when you navigate to the wallet page or after a transaction completes.

#balance#wallet

The Wallet page has a Transactions tab showing your complete payment history โ€” deposits, VPS subscription payments, scale charges, and any refunds. Each entry shows the date, amount, token, and transaction type. You can also see a detailed view under Transactions in the sidebar which includes subscription-level billing events.

#transactions#history#billing

The Wallet page โ†’ Deposits tab lists all your deposit requests with their current status:

Pending Review โ€” submitted and awaiting admin review.
Approved โ€” admin approved, tokens minted to your wallet.
Rejected โ€” admin rejected (e.g. proof of payment unclear). You may resubmit with a clearer image.

Tap any deposit row to see details including the proof of payment you uploaded.

#deposits#status#tracking

Security

4 questions

Root access is provided for maximum flexibility. For better security we recommend:

1Create a non-root user and add it to the sudoers group after first login.
2Disable password authentication and switch to SSH key-based auth by editing /etc/ssh/sshd_config.
3Set up a firewall (ufw or iptables) to allow only necessary ports.
4Regularly update packages with apt update && apt upgrade.

Grapthway provides root access as a starting point โ€” securing it further is your responsibility.

#security#ssh#root

Yes. After your first password login, add your public key to ~/.ssh/authorized_keys on the VPS. You can then disable password auth in /etc/ssh/sshd_config (set PasswordAuthentication no) and restart sshd. SSH keys are significantly more secure than passwords and immune to brute-force attacks.

#ssh#keys#authentication

All SSH sessions are encrypted in transit using standard SSH encryption (AES-256). Data at rest on the VPS disk is not encrypted by default โ€” if you need at-rest encryption, you can set up LUKS or similar block-level encryption inside your VPS. The Grapthway platform itself communicates internally over encrypted channels.

#encryption#security#data
Use a strong, unique password for your Grapthway account.
Never share your wallet seed or account credentials.
Log out after using shared devices.
If you suspect unauthorised access, contact support immediately and change your password via the Forgot Password flow.
Keep your email address current so you receive security notifications.
#account#security#password

Troubleshooting

6 questions

1Open Jobs in the sidebar and find the failed provisioning job.
2Read the log output โ€” stderr lines (in red) usually identify the exact error.
3Common causes: node agent timeout (try redeploying on a different node), port conflict (choose a different SSH port), or disk quota exceeded on the node.
4If the error is unclear, contact support with the Job ID so the team can investigate the node-side logs.
#error#provisioning#troubleshoot
1Confirm the VPS status is Running (not Provisioning or Error).
2Verify you are using the correct node IPv4 and SSH port shown on your VPS card.
3Check your SSH port is not blocked by a local firewall on your machine.
4Make sure you are using the correct password (reset it if unsure via Reset SSH Password).
5If you set up a firewall inside the VPS (ufw/iptables) that blocks SSH โ€” you may be locked out. Contact support to access the VPS console.
#ssh#connection#troubleshoot

The token payment selector highlights your balance in red when it falls below the quoted total. Deposit the required amount and wait for admin approval before retrying. Make sure you are selecting the correct token โ€” e.g. if your subscription tier accepts IDR, you need an IDRG balance, not GCU.

#balance#payment#troubleshoot

Nodes with zero CPU, RAM, or disk are automatically hidden from the node selection list. If the node you prefer is not showing, it means it has no capacity for the selected tier. Options:

Choose a different node in the same region.
Choose a different tier that has capacity on that node.
Wait for capacity to free up (other subscriptions may expire or be deleted).
Contact support to request priority placement or a new node in your preferred region.
#capacity#node#troubleshoot

Deposits are reviewed by admins, typically within a few hours during business hours. If your deposit has been pending for more than 24 hours:

1Check the Wallet โ†’ Deposits tab to confirm the deposit shows Pending Review status.
2Ensure you uploaded a clear proof of payment image showing the transaction amount and reference.
3Contact support with your deposit ID and the payment reference number so an admin can manually verify.
#deposit#pending#troubleshoot
1Confirm you pointed the DNS A record to the correct node IPv4 (shown on your VPS card).
2DNS propagation can take 5โ€“60 minutes โ€” use a tool like dnschecker.org to verify propagation.
3Make sure your VPS service is listening on the internal port you configured in the Setup Domain modal.
4Check that the protocol (HTTP vs HTTPS) matches. HTTPS requires a TLS certificate inside your VPS.
5Confirm the VPS is in Running state and the node agent is healthy.
#domain#dns#troubleshoot

Platform & Network

5 questions

The Grapthway Protocol is the decentralized orchestration layer that connects the web platform to physical node operators. It uses a pipeline-based workflow system (called Grapthway pipelines) to coordinate multi-step operations โ€” like provisioning a VPS โ€” across multiple microservices (subscription, wallet, node-host) atomically. Node operators register their servers as Grapthway agents and receive job payloads to execute.

#protocol#decentralized#architecture

Nodes are operated by independent node operators โ€” individuals or organisations that register their physical servers with Grapthway. Each operator runs the Grapthway agent software which accepts provisioning jobs from the platform. Operators are vetted before their nodes are made available to users. The platform tracks node status, resource allocation, and uptime through the node-host microservice.

#operators#nodes#infrastructure

Grapthway targets 99.9% platform availability. Individual node uptime depends on the node operator. Nodes in a Draining or Suspended status are not shown to new users โ€” only Active nodes accepting deployments are listed. If a node goes offline unexpectedly, the platform monitoring system detects this and the operations team is alerted. Users with affected VPS are contacted directly.

#uptime#sla#reliability

The Grapthway backend is composed of independent Go microservices:

ms-node-host โ€” manages node registration, tier allocations, port bookings, and resource tracking.
ms-subscription โ€” handles VPS subscription lifecycle (create, scale, extend, close).
ms-wallet โ€” manages on-chain wallets, token balances, deposit requests, and payment events.
ms-product โ€” stores tier definitions, pricing per currency, and discount programs.
server-vps โ€” orchestrates VPS operations through the Grapthway pipeline, proxies agent commands.
server-authentication โ€” handles user accounts, JWT sessions, and admin roles.

All services communicate through the Grapthway pipeline system for atomic multi-step operations.

#architecture#microservices#technical

Your VPS data (files, databases, applications) lives on the physical disk of the node operator's server in the region you chose. Platform metadata (account, subscription, billing records) is stored in the Grapthway cloud database. Payment and wallet data is recorded on the Grapthway Protocol blockchain. Review our Privacy Policy for full details on data handling.

#data#storage#privacy

Account & Settings

4 questions

Click the Preferences icon in the top navigation bar (gear icon). Select your preferred language from the Language dropdown. The change is applied immediately and persisted to your account so it follows you across devices.

#language#settings#preferences

Open the Preferences panel via the gear icon in the navbar. Toggle between Dark and Light theme. The theme is saved to your account and applied on every subsequent login.

#theme#dark mode#preferences

On the login page, click Forgot Password. Enter your registered email address and we will send a password reset link. Follow the link in the email to set a new password. The link expires after 24 hours. If you do not receive the email, check your spam folder or contact support.

#password#reset#account

For general questions, consult this FAQ first. For account-specific issues, billing disputes, or urgent technical problems:

Email: support@grapthway.dev
Include your account email, a description of the problem, and any relevant Job ID, Deposit ID, or VPS name to speed up resolution.

Admin-level issues reported through the platform are handled within business hours.

#support#contact#help

Still have questions?

Our support team is ready to help with anything not covered here.

Contact Support