Support / Knowledge Base

Knowledge Base

Guides and troubleshooting articles for common Colioe issues.

VM Not Booting

  • Check the VM console output in your dashboard under Compute → Instances → Console.
  • Ensure the boot disk has sufficient storage (minimum 20 GB recommended for Linux, 40 GB for Windows).
  • Verify the selected OS image is compatible with the chosen VM size.
  • If the VM is stuck in "Starting" state for more than 5 minutes, try a hard reboot from the dashboard.
  • Review recent changes to network security groups — a misconfigured rule can prevent boot scripts from completing.
  • If the issue persists, contact support at support@colioe.io with your instance ID.

Network Connectivity Problems

  • Confirm your VM's network interface is attached and the IP address is assigned (check the Networking tab in the dashboard).
  • Verify firewall/security group rules allow inbound traffic on the required ports (e.g., 80, 443, 22).
  • Test connectivity from inside the VM using ping 8.8.8.8 to check outbound internet access.
  • For DNS resolution failures, try setting a public DNS server (e.g., 1.1.1.1 or 8.8.8.8).
  • If connecting via SSH, ensure port 22 is open in your security group and your SSH key is correctly added.
  • Check for IP conflicts if using a custom VPC CIDR range.

Deployment Failures

  • Review the build log in the dashboard under Deploy → Deployments → [failed deploy] → Logs.
  • Ensure all required environment variables are set in the project settings before deploying.
  • Confirm the build command and output directory match your project structure.
  • Check that the Node.js, Python, or runtime version specified in your config matches what your app requires.
  • If using a monorepo, verify the root directory is correctly configured.
  • Dependency install failures often indicate a package.json lockfile mismatch — try clearing the cache and redeploying.

Billing Questions

  • View current charges and upcoming invoices in the dashboard under Settings → Billing.
  • Colioe bills on a monthly cycle. Charges are calculated based on actual usage (mailboxes, VM hours, bandwidth).
  • Update your payment method at any time under Settings → Billing → Payment Methods.
  • To cancel a service, navigate to the service in the dashboard and click Deactivate. You will not be charged for the next billing period.
  • For disputed charges or invoicing questions, email billing@colioe.io with your account ID and invoice number.
  • Refunds are processed per the Refund Policy available at colioe.io/refund-policy.

CLI Installation Issues

  • Install the CLI with: npm install -g @colioe/cli
  • If npm throws a permissions error on macOS/Linux, use: sudo npm install -g @colioe/cli or configure npm to use a local prefix.
  • On Windows, run the command in an Administrator PowerShell or Command Prompt.
  • After install, verify with: colioe --version
  • If the command is not found after install, ensure your npm global bin directory is in your PATH.
  • To update to the latest version: npm update -g @colioe/cli

API Rate Limits

  • The Colioe API allows 300 requests per minute per API key by default.
  • Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
  • When the limit is exceeded, the API returns HTTP 429 Too Many Requests.
  • Implement exponential backoff in your client: wait before retrying after a 429 response.
  • For higher rate limits, contact sales@colioe.io to discuss an enterprise plan.
  • Batch operations (e.g., sending multiple emails in one request) count as a single API call.

Can't find what you're looking for?

Contact Support