NodeOps
IN

Troubleshooting

Common issues and how to resolve them.


"you're not signed in"

Cause: Your session has expired or you haven't logged in.

Bash
1createos login

For CI environments:

Bash
1createos login --token

"no project linked to this directory"

Cause: No .createos.json file found in the current directory or any parent directory.

Bash
1createos init

Or specify the project explicitly:

Bash
1createos deploy --project <your-project-id>

To find your project ID:

Bash
1createos projects list

"command not found: createos"

Cause: The CLI binary is not in your PATH.

If installed via Homebrew

Bash
1brew link createos

If installed via curl

The installer places the binary in /usr/local/bin. Verify:

Bash
1ls -la /usr/local/bin/createos

If missing, reinstall:

Bash
1curl -sfL https://raw.githubusercontent.com/NodeOps-app/createos-cli/main/install.sh | sh -

Deploy hangs or times out

Cause: Build is taking longer than expected, or there's a network issue.

  1. Check build logs:
Bash
1createos deployments build-logs
  1. If the deployment is stuck, cancel and retry:
Bash
1createos deployments cancel
2createos deploy
  1. Enable debug mode to see HTTP requests:
Bash
1createos --debug deploy

Interactive prompts not working

Cause: You're running in a non-TTY environment (CI, pipe, script).

Use explicit flags instead:

Bash
1# Instead of interactive selection
2createos env list --project <id> --environment <id>
3
4# Skip confirmations
5createos domains delete --project <id> --domain <id> --force

"environment not found"

Cause: The environment ID in .createos.json no longer exists, or you have multiple environments and need to specify one.

Bash
1# List available environments
2createos environments list
3
4# Use a specific environment
5createos env list --environment <env-id>
6
7# Re-link with correct environment
8createos init --project <project-id>

Updating the CLI

If you're on an old version and something isn't working:

Bash
1createos upgrade

Or via Homebrew:

Bash
1brew upgrade createos

Check your current version:

Bash
1createos version

Debug mode

For any issue, run the command with --debug to see full HTTP request/response details:

Bash
1createos --debug status

Tokens are automatically masked in debug output.


Getting help

1,00,000+ बिल्डर। एक कार्यक्षेत्र।

उत्पाद अपडेट, बिल्डर कहानियाँ, और उन सुविधाओं तक पहले पहुँच प्राप्त करें जो आपको तेज़ी से शिप करने में मदद करती हैं।

CreateOS एक एकीकृत बुद्धिमान कार्यक्षेत्र है जहाँ विचार अवधारणा से लाइव डिप्लॉयमेंट तक सहजता से आगे बढ़ते हैं, टूल, इन्फ्रास्ट्रक्चर और वर्कफ़्लो में कॉन्टेक्स्ट-स्विचिंग को समाप्त करते हुए CreateOS मार्केटप्लेस पर तुरंत विचारों को मुद्रीकृत करने का अवसर प्रदान करता है।