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
Copy
1createos login

For CI environments:

Bash
Copy
1createos login --token

"no project linked to this directory"

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

Bash
Copy
1createos init

Or specify the project explicitly:

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

To find your project ID:

Bash
Copy
1createos projects list

"command not found: createos"

Cause: The CLI binary is not in your PATH.

If installed via Homebrew

Bash
Copy
1brew link createos

If installed via curl

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

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

If missing, reinstall:

Bash
Copy
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
Copy
1createos deployments build-logs

2. If the deployment is stuck, cancel and retry:

Bash
Copy
1createos deployments cancel
2createos deploy

3. Enable debug mode to see HTTP requests:

Bash
Copy
1createos --debug deploy

Interactive prompts not working

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

Use explicit flags instead:

Bash
Copy
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
Copy
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
Copy
1createos upgrade

Or via Homebrew:

Bash
Copy
1brew upgrade createos

Check your current version:

Bash
Copy
1createos version

Debug mode

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

Bash
Copy
1createos --debug status

Tokens are automatically masked in debug output.

Getting help

• CLI help: createos <command> --help
• GitHub Issues: Report a bug
• Documentation: CLI Docs