Repository navigation
Troubleshooting
kz6fittycent edited this page Nov 3, 2026
·
1 revision
| You see | What to do |
|---|---|
| Download failed! Please check your internet connection and retry. | Check your internet connection and press Retry Download. |
| Nothing happens when you open Minecraft | Run mc-installer in a terminal and look at what it prints. Include that if you open an issue. |
| The launcher asks you to sign in every time | Open an issue with your Linux version (lsb_release -a). |
| Clicking in the launcher does nothing, or menus close by themselves | Try the Tab and Enter keys to get through, and open an issue saying which graphics card you have. |
| You see | What to do |
|---|---|
| The game window is see-through or black | Update the snap (sudo snap refresh mc-installer); versions before 14.3 had this problem on some NVIDIA PCs. |
| On a laptop with two graphics cards, the game is slow | Right-click Minecraft in the app grid and choose Launch using Discrete Graphics Card. |
| Couldn't load Narrator library in the logs | Harmless: only the narrator (text-to-speech) is affected. |
| The game closes straight after starting | Look at the last lines of logs/latest.log (see Files and Backups). With mods, it usually names the mod at fault. |
| You see | What to do |
|---|---|
| Incompatible version or Outdated client/server | Play the server's Minecraft version: see Playing on a Server. |
| Connection Lost mentioning registry entries, or a mod | The server needs a mod you don't have: see Mods, Joining a server that has mods. |
| Can't connect to server | Check the address, and that the server is running. At home, both computers must be on the same network. |
See the table at the end of Mods.
Open an issue and include:
- what you did and what you saw (a screenshot helps)
-
snap info mc-installer | tail -3(which version you have) - for game problems,
logs/latest.log
Getting started
Later on