Skip to main content

Troubleshooting Common Issues

This page covers common issues you may encounter when using Deep Code and how to resolve them.

Error: "Cannot connect to server, please check your network"​

Issue: Error when running Deep Code: Cannot connect to server, please check your network

This error indicates that the terminal cannot establish a connection with the AI model server, preventing it from calling the AI model to complete tasks. There are three possible causes — please check each one:

1. Network Connection Issue​

Verify that your computer can access the internet. The easiest way to test this is to open a browser and navigate to any website (e.g., bing.com). If the page loads normally, your network connection is working. If not, check your network settings.

2. System Clock Out of Sync​

Communication between the terminal and the server uses an encrypted protocol that enforces strict time validation. If your computer's clock is off by more than 1 hour from the actual time, the connection will fail. Adjust your system clock to the correct time:

  • Windows: Right-click the taskbar clock → Adjust date/time → Enable "Set time automatically"
  • macOS: System Settings → General → Date & Time → Enable "Set date and time automatically"
  • Linux: System Settings → General → Date & Time → Enable "Set date and time automatically"

After correcting the system clock, re-open Deep Code to resolve the issue.

3. Firewall Blocking the Connection (Windows)​

Windows Firewall may be blocking the application's network access. Follow these steps to allow it through:

  1. Open Windows Security
  2. Select Firewall & network protection → Allow an app through the firewall
  3. Click "Change settings," find and check the Deep Code application
  4. Save the settings

Linux: AppImage Won't Launch​

Issue: The AppImage file has execute permission enabled, but Deep Code still won't launch when double-clicked​

Tip: You can launch the Deep Code AppImage from the command line terminal to see detailed error messages.

Troubleshooting

  1. Open a terminal and navigate to the directory containing the Deep Code AppImage file.
  2. Type ./Deep Code.AppImage and press Enter to run Deep Code.

Error: Permission denied​

⛔ Error: Permission denied

Solution

This error indicates that the AppImage file does not have execute permission. Run the following command in the terminal to add execute permission to the AppImage file:

chmod +x ./*.AppImage

Then re-run the Deep Code AppImage file to resolve the issue.

Error: libfuse.so.2 missing​

⛔ dlopen(): error loading libfuse.so.2

AppImages require FUSE to run.
You might still be able to extract the contents of this AppImage
if you run it with the --appimage-extract option.
See https://github.com/AppImage/AppImageKit/wiki/FUSE
for more information

Solution

The Deep Code AppImage requires the libfuse2 module to run. Follow these steps to install FUSE:

sudo apt update
sudo apt install libfuse2

If the package cannot be found, try the t64 package name used by Debian and newer distributions:

sudo apt install libfuse2t64

Then re-run the Deep Code AppImage file to resolve the issue.