Troubleshooting

Having issues? Start with a health check, then check the common problems below.

---

First Step: Health Check

Always start here

Open the Profiler panel and click Health. This diagnoses most issues and offers one-click fixes.

The health check will tell you exactly what’s wrong and how to fix it.

Learn more about Health Check →

---

Common Issues

JVM Not Showing Up

Symptoms: Your Java app is running but doesn’t appear in the JVM list.

Solutions:

1. Click Refresh in the profiler panel
2. Make sure your Java app is actually running
3. Run a Health Check — the controller might not be running

---

No Metrics Appearing

Symptoms: Profiling is active but no metrics show up.

Solutions:

1. Check the status bar — it should say “Profiling”
2. Make sure your code matches the package filter
3. Open some files from the profiled package
4. Wait a few seconds for data to arrive

---

Inline Hints Not Visible

For IntelliJ:

1. Go to Settings → Editor → Inlay Hints
2. Find Code Vision → GalataJ
3. Make sure it’s enabled
4. Restart the IDE if needed

For VS Code:

1. Check that profiling is active (status bar)
2. Open a file from the profiled package
3. Try reloading the window

---

Controller Won’t Start

Solutions:

1. Run Health Check and click Fix next to the error
2. Restart your IDE
3. Make sure no other application is using the required ports

---

Profiling Won’t Start

Solutions:

1. Run Health Check first
2. Make sure a JVM is selected
3. Click Refresh to update the JVM list
4. Restart the IDE

---

Plugin Not Loading

Solutions:

1. Restart the IDE after installation
2. Check the plugin is enabled in Settings → Plugins
3. Make sure your IDE version is supported:
   • IntelliJ IDEA 2024.1 or later
   • VS Code 1.80 or later

---

Hard Reinstall

If nothing else works, you can do a complete reinstall to start fresh.

Step 1: Uninstall the Extension

IntelliJ: Settings → Plugins → Find GalataJ → Uninstall

VS Code: Extensions sidebar → Find GalataJ → Uninstall

Step 2: Stop the Controller

Open a terminal and run:

galataj controller stop

Step 3: Delete Configuration

Delete the .galataj folder in your home directory:

Windows:

Remove-Item -Recurse -Force "$env:USERPROFILE\.galataj"

macOS / Linux:

rm -rf ~/.galataj

Step 4: Reinstall

1. Install the extension from the marketplace
2. Open the extension — the Setup Wizard will guide you
3. Activate your license if you have one

---

Still Having Issues?

Check Health

The health check catches most issues automatically

Run Health Check →

Report a Bug

Open an issue on GitHub with details about your problem

Open Issue →

---

Quick Fixes Summary

Problem	Quick Fix
JVM not found	Click Refresh in panel
No metrics	Check package filter matches your code
Hints not showing	Settings → Inlay Hints → GalataJ
Controller issues	Run Health Check → Click Fix
General issues	Restart IDE
Nothing works	Hard Reinstall