Common Issues

Solutions for frequently encountered problems and error messages in Gophel CLI.

Authentication Issues

Error: Not authenticated

Solution: Run gophel auth and provide your credentials

Error: Session expired

Solution: Run gophel auth to refresh your session

Error: Invalid API key

Solution: Verify your API key and try again

Build Issues

Error: Go not installed

Solution: Install Go manually or let Gophel install it automatically on Linux

Error: Build failed

Solution: Check your Go code for errors and verify dependencies

Error: Port already in use

Solution: Choose a different port or stop the application using the current port

Application Control Issues

Error: Application not found

Solution: Verify the application ID with gophel list

Error: Cannot start application

Solution: Check logs and verify port availability

Error: Permission denied

Solution: Check file permissions and run with appropriate privileges

Monitoring Issues

Error: Cannot connect to server

Solution: Check network connectivity and server status

Error: WebSocket connection failed

Solution: Verify firewall settings and server availability

Error: Server not responding

Solution: Check server status and network connectivity

File System Issues

Error: Cannot create directory

Solution: Check directory permissions and disk space

Error: Cannot write to file

Solution: Verify file permissions and disk space

Error: Configuration file not found

Solution: Run gophel init to create configuration