macOS Catalina problems: how to fix the most common macOS Catalina issues

Person using a MacBook
(Image credit: Shutterstock; Apple)

If you’re experiencing macOS Catalina problems, you’re not alone - problems arise in operating systems all the time. We’re here to help you make sure those issues get fixed on your MacBook or Mac so you can get back to using your Apple product as intended. 

It might seem daunting to tackle macOS Catalina problems on your own, but that’s why we’ve crafted this guide to help you fix the most common problems. If you've invested in one of the best MacBooks and Macs and are struggling with installation issues, hardware malfunctions or software faults, we have a range of fixes that should address those problems with ease.

Many macOS Catalina problems can be solved by rebooting your system or clearing out your storage because it’s low on space. However, using outdated apps can clash with your OS, or using an older Mac product may mean it’s incompatible with the newest operating system. You don’t have to worry about downgrading your macOS yet, though, as there are plenty of ways to troubleshoot your issues before having to load macOS Mojave again.

We’ve addressed a variety of common macOS Catalina problems in this guide, but that doesn’t guarantee we’ll have your issue on the list. We understand that there are some special cases that require more than a common solution. If this is the case, be sure to follow and tweet the details to us so we can help you find a fix.

If you haven’t installed this macOS yet, consider upgrading to macOS Monterey and visit our how to download and install macOS Monterey guide for a step-by-step process of getting the software on your Mac or MacBook. If you’d instead like to go back to the previous macOS, we have a guide for how to downgrade macOS too. 

Woman typing on MacBook in cafe

The macOS 10.15 failing to download is one of the most common macOS Catalina problems people encounter. (Image credit: Shutterstock)

How to fix macOS Catalina download problems

One of the most common macOS Catalina problems that people have encountered is that macOS 10.15 fails to download, with some users seeing an error message that says “macOS Catalina download has failed."

Others, on the other hand, are seeing "The network connection was lost" error messages when they try to download macOS Catalina.

In addition, a few get the error message: “Installation of macOS could not continue. Installation requires downloading important content. That content can’t be downloaded at this time. Try again later.”

There are a few reasons why you may encounter this issue. It may be because a lot of people are trying to download macOS Catalina at the same time. If you think this is the case, try again later on a non-peak time to see if the download works then. You can also check the live status of the Apple Server to make sure everything is alright on Apple's end.

Another reason could be that you simply do not have enough space on your computer. Typically, a macOS download fails if you do not have enough storage space available on your Mac.

To make sure you do, open up the Apple menu and click on 'About This Mac.' Select 'Storage' then check to make sure you have enough space on your hard drive. You need at least 15GB free. If you're running low, open up the Apple menu, click 'About this Mac' then go to Storage > Manage and free up some disk space there.

It may also be worth switching from a Wi-Fi connection to an Ethernet cable, to ensure your internet connection is as reliable as possible.

If you’re still having problems downloading macOS Catalina, try to find the partially-downloaded macOS 10.15 files and a file named ‘Install macOS 10.15’ on your hard drive. Delete them, then reboot your Mac and try to download macOS Catalina again.

And, if that doesn’t work, try opening the App Store and clicking ‘View My Account’ to see if there is anything in the ‘Unfinished Downloads’ section. You may be able to restart the download from there.

Finally, try logging out of the Store to see if that restarts the download.

How to fix "gateway timed out" error when downloading macOS Catalina

In addition, there’s been a lot of complaints regarding the download stopping at around 511.5MB when downloading and installing macOS Catalina, and the system throwing up a "gateway timed out" or "bad gateway" error.

If you are having this issue, try starting your Mac in Safe Mode (hold down Shift on the keyboard while it boots), then try downloading and installing macOS Catalina again.

Shot of macOS Catalina

There are several possible reasons why the macOS is having issues installing. (Image credit: Shutterstock/Apple)

How to fix macOS Catalina install problems

If your macOS Catalina problem is in installing the operating system, first make sure you check out our how to download and install macOS Catalina guide, which will take you through the steps you need to take to safely install the new operating system.

First of all, you'll want to make sure you have a Mac that can run macOS Catalina. The following Macs are compatible:

  • 12-inch MacBook (2015 and later)
  • MacBook Air (2012 and later)
  • MacBook Pro (2012 and later)
  • Mac mini (2012 and later)
  • iMac (2012 and later)
  • iMac Pro (2017)
  • Mac Pro (2013 and later)

When you have a compatible Mac and the macOS Catalina download completes, but there’s no prompt for the installation to continue, then search in your Mac’s application folder for a file called 'Install macOS 10.15'. Double-clicking the file should begin installation.

If you encounter the macOS Catalina problem where the installation fails due to low disk space, simply restart your Mac and press Control + R while it’s booting to enter the Recovery mode. Select ‘Disk boot’ to boot normally, then remove unnecessary files to make space.

macOS Catalina is stuck on 'Setting Up Your Mac'

We've had readers contact us saying that after installing macOS Catalina, their Macs show the 'Setting Up Your Mac' message, but nothing else happens.

If this is the case, you'll need to force a reboot of your Mac or MacBook. Don't worry, the 'Setting Up Your Mac' message means the update is finished, so you won't lose any data or damage anything by restarting your Mac.

To do so, press and hold down the power button for a few seconds until the Mac or MacBook turns off. Wait a few more seconds, then turn it back on. Your Mac or MacBook should now boot into macOS Catalina successfully.

Time remaining on download screen

macOS Catalina problems during installation isn't as rare as you think, and there are a few ways to fix the issue.

If you’re struggling to free up disk space, look out for hidden Time Machine files that may be taking up large amounts of space.

Once you have freed up enough space, retry the installation.

If macOS Catalina encounters a problem at the end of installation, and then shows an error message, restart your Mac and press Command + Option + R on your keyboard while the Mac boots to start up the recovery system over the Internet. You can also try Shift + Option + Command + R.

If your Mac continues to fail to boot, follow Apple’s instructions on creating an external Mac startup disk.

It may be worth restarting your Mac in Safe Mode, then trying to install macOS 10.15 Catalina from there to fix the problem.

How to fix macOS Catalina login problems

If you're having trouble logging into your Mac or MacBook after installing macOS Catalina, or you're stuck in a loop where you log in, then get logged out again, the following steps might help.

First, restart your Mac and hold down the Command + S keys on your keyboard as it boots up.

This will boot you into a command prompt. Now, enter in the following:

/sbin/mount -uw /

Press Enter on your keyboard. Then enter in the following:

rm /var/db/.applesetupdone

This removes a file, which makes it appear like you're starting Catalina up for the first time. Don't worry, nothing important is getting deleted. Press Enter, then restart your Mac.

You will then be asked to create a new admin user account.

How to fix macOS Catalina email problems

Some readers have got in contact to let us know that they are experiencing problems with the Mail app in macOS Catalina. If you use Mail to read and send emails, and it's not working correctly after installing macOS Catalina, read on to find out how you can fix the most common issues.

If Mail keeps crashing while you use it, open up Finder and then click on 'Go' from the top menu and select 'Go to Folder'.

Next, type in:

~/Library/Containers/ Application State/

Scroll down and find '' and then move it to Trash.

Next, go back to the 'Go to Folder' window and type in:


Find and and move them, either to Trash or somewhere temporary (like your desktop).

Then, go to:


Find Envelope Index, Envelope Index-shm and Envelope Index-wal to Trash. Empty Trash, then restart your Mac and see if that works.

macOS Catalina breaks search in Mail - here's how to fix it

There are reports that the search function no longer works in the Mail app after installing macOS Catalina.

The first thing to try, if you encounter this problem, is first close Mail completely. Then hold Shift and click on the Mail icon to open it in Safe Mode. Then, close Mail again, then hold Shift and open Mail again.

Finally, close Mail yet again, then reboot your Mac. Open Mail normally, and search should work again.

If that doesn't work, and you're using a Gmail account, that could be the issue.

Go to System Preferences > Internet Accounts and turn off Gmail. Reboot the Mac and load up Mail to see if search works.

If it does, you can then go back to System Preferences and add your Gmail account again.

Is macOS Catalina running slowly? Here's how to fix it

Once macOS Catalina is installed on your Mac or MacBook, you may notice that your device is running slower than before.

If macOS Catalina also showed a notification that said "Optimizing Your Mac: Performance and battery life may be affected until completed," then this is normal, as macOS Catalina is doing things behind the scenes which can initially impact performance.

After a day or so, your Mac should be running just as well (if not better) as before. If you don't see an improvement by then, try restarting your Mac or MacBook. 

Another thing to check is to make sure that all of your apps and software are updated to the latest version. If any of them have issues with Catalina, that could be slowing down your machine.

You can also open up the Apple menu and select 'System Preferences'. From the window that appears, click 'Users & Groups'. Select 'Login Items' and then select the apps you want to stop opening at startup and click the small minus sign below the list.

It's also worth making sure all of your apps are updated. Check the App Store for any available updates, or the app's website.

You can also try restarting your Mac to see if that helps. If it doesn't, force-quit any apps that appear to be taking up a lot of RAM. You can identify these by using Activity Monitor (in /Applications/Utilities) to establish what apps and processes are using up the most CPU or RAM. Its CPU tab lists active processes, with a real-time view of what's going on.

To force-quit an item, click it in the Activity Monitor list, click the X at the left of the toolbar, then confirm you want to force-quit.

Also delete the cache. Open the Finder window, select 'Go' from the top menu and select 'Go to Folder'.

In the text box that appears, type /Library/Caches.

Remove the data from inside every folder. Now repeat the process with /Library/Caches (without the symbol). Running the Repair Disk tool from within Disk Utility may also help, and for more solutions check out our How to speed up your Mac guide. 

How to fix macOS Catalina battery issues

As with the performance issues above, you may find that at first your MacBook's battery life is a lot shorter. Again, this is probably because macOS Catalina is doing some background work to set itself up – and after a few hours or a day, things should have settled down and your battery life should be back to normal.

If it isn't then make sure all your apps are updated. You can also click the battery icon on the top menu bar, which will show you what apps and processes are taking up a lot of your battery life. Close those and see if the battery improves.

If it does, then make sure the apps in question have been updated, and check any of their settings to see why they would be taking up so much battery life in macOS Catalina.

For more advice, visit our how to improve your MacBook's battery guide.

Mouse that goes with MacBook

Found out your mouse no longer works? We'll tell you how to fix that.

How to fix macOS Catalina mouse problems

If you've installed macOS Catalina and found your mouse no longer works, open up the  ~/Library/Preferences/ directory in finder and select and delete the following files:


You may need to restart your Mac to get the mouse working.

MacBook Pro (15-inch, 2019)

Is your MacBook keyboard not working on macOS Catalina? There's a simple fix. (Image credit: Future)

How to fix macOS Catalina MacBook keyboard problems

Here's an odd one. Some people have been complaining that after updating to macOS Catalina, the keyboards of their MacBooks no longer work.

Luckily, there's quite an easy fix. Restart the MacBook, and once macOS Catalina has loaded, close the lid of the MacBook for a few seconds. Then, open it back up, and the keyboard should begin working again.

Hopefully Apple releases a fix for this bug soon – but at least it's relatively easy to get around for now.

Bluetooth symbol

There's an easy way to fix issues with Bluetooth devices not working in macOS Catalina.

How to fix macOS Catalina Bluetooth issues

To fix issues with Bluetooth devices not working in macOS Catalina try opening up Finder and then click on 'Go' in the top menu, then 'Go to Folder...'.  Type in '/Library/Preferences'. 

From there, you should see a file called ' '. Select and delete the file (or move it to another folder for safe keeping), then restart your Mac and try connecting your Bluetooth device again.

How to fix macOS Catalina boot problems

If you've installed macOS Catalina, but your Mac won't start, then restart your Mac and hold down Command, Option, P and R, which will reset the NVRAM (non-volatile RAM).

Hold the keys down until the computer restarts and you hear the startup chime for the second time. Release the keys after you hear the second startup chime. The PRAM will be reset as well.

While in Safe Mode, run Disk Utility to see if that will fix any macOS Catalina boot problems.

For other ways to fix a Mac that won't start, check out our guides how to Use OS X boot options to troubleshoot your Mac and how to fix a Mac that won't start.

How to fix macOS Catalina Finder problems

Some people have found that Finder has been crashing or becoming unresponsive after updating to macOS Catalina.

If you have encountered this problem, open up Terminal and enter the following command:


Press Enter. You will see a highlighted in Finder. Select the file, then delete it. Next, restart the Mac.

PDF document

Apps that don't have a 64-bit version will not work on macOS Catalina.

Apps won't work in macOS Catalina

One of the most controversial changes included with macOS Catalina is the fact that it no longer supports 32-bit apps. This means any apps that don't have a 64-bit version will no longer work.

Apps that will be killed off in macOS Catalina include Transmist 4.1.7, 1Password 2.12.2, iStats Menu 2.9 and QuickBooks 2015. You can view the full list of the apps at The Tape Drive.

While most apps will hopefully have 64-bit updates, there will be many that don’t, which is bad news if you rely on them and upgrade to macOS Catalina.

If you’re concerned that an app you rely on will no longer work in macOS Catalina, you should check to see if you have any 32-bit apps on your system.

To do this, click on the Apple icon at the top of your screen, then select ‘About This Mac’. Click ‘System Report’ and then go to the ‘Software’ section.

Click ‘Applications’ and you’ll see a list of apps. There will be a column called ’64-bit (Intel)’. If an app has ‘No’ in that column, then it means it won’t be supported in macOS Catalina.

You can check the list on The Tape Drive as well to see if your apps are listed there.

If you do have any 32-bit apps installed, you’ll need to check to see if there is a 64-bit version (if the app has a website, it should say whether one is available).

If not, you’ll need to find an alternative app that performs the same function but is 64-bit. Our guide to the best Mac apps will help you.

Woman using laptop and tablet

If you're having issues getting Sidecar to work in macOS Catalina, there are a few things to check. (Image credit: Apple)

How to fix macOS Catalina Sidecar problems

Sidecar is one of the best macOS Catalina features, allowing you to use a compatible iPad as a second screen.

However, if you're having issues getting Sidecar to work in macOS Catalina, there are a few things to check.

To use Sidecar, you need one of the following iPad models:

  • iPad 6
  • iPad 7
  • iPad mini 5
  • iPad Air 3
  • Any iPad Pro

The iPad needs to have the new iPadOS software installed as well.

You also need to make sure you have a compatible Mac:

  • iMac 27-inch (Late 2015 or newer)
  • MacBook Pro (2016 or newer)
  • Mac mini (2018)
  • Mac Pro (2019)
  • MacBook Air (2018)
  • MacBook (Early 2016 or newer)

If you don’t own one of the above, all is not lost. Reddit user u/dotmax has discovered that you can use Sidebar on older Macs by running a Terminal command – but we wouldn't recommend it, as the results aren't great.

Make sure you check out our how to use Sidecar in macOS Catalina guide for an in-depth look at this excellent feature.

How to fix macOS Catalina Wi-Fi problems

If you're having issues with connecting to the internet, either via Wi-Fi or an Ethernet (wired) connection after installing macOS Catalina, then try starting your Mac in Safe Mode and see if you can connect.

If you can, it means that there's an issue with an app or extension that you have installed. Make sure you have updated your drivers and apps, and keep an eye out for an Apple update in the future.

Is Catalina the newest macOS?

No, Catalina is not the most recent macOS - it was released October 2019 after September 2018’s macOS Mojave. macOS 11 Big Sur came after Catalina and was released in November 2020, and has since been updated as of October 2021 to macOS Monterey. If you’re happy using Catalina or Big Sur you don’t have to upgrade your macOS, but you’ll get to take advantage of some cool new and improved features if you do choose to switch.

macOS 11 Big Sur was one of the most impressive Apple OS versions to date because it took full advantage of the M1 chip released in 2020’s Mac mini, MacBook Air, and MacBook Pro 13-inch. Now macOS 12 Monterey is even more impressive than Big Sur, specifically released to showcase 2021’s MacBook Pro 14-inch and 16-inch.

If you’ve decided to make the jump from Catalina to Monterey, you may experience some common macOS Monterey problems. There’s no need to worry though, because just like Catalina, Monterey will have some growing pains that are easy to fix - especially when you have our guide to help each step of the way. 

Matt Hanson
Managing Editor, Core Tech

Matt is TechRadar's Managing Editor for Core Tech, looking after computing and mobile technology. Having written for a number of publications such as PC Plus, PC Format, T3 and Linux Format, there's no aspect of technology that Matt isn't passionate about, especially computing and PC gaming. He’s personally reviewed and used most of the laptops in our best laptops guide - and since joining TechRadar in 2014, he's reviewed over 250 laptops and computing accessories personally.