EUDI Wallet App Won't Install or Download

Recognising Installation Problems

Installation issues with the EUDI Wallet can manifest in several different ways. Understanding exactly what you are experiencing helps pinpoint the right solution. Here are the most common symptoms users encounter:

• Download fails or stalls at a percentage -- the progress bar stops moving, eventually showing an error message or timing out.
• "Incompatible device" warning -- the App Store or Google Play displays a message saying the app cannot be installed on your device.
• App not found in store -- searching for "EUDI Wallet" or your national wallet name returns no results.
• "Insufficient storage" error -- your phone reports there is not enough space to complete the installation.
• Installation completes but app will not open -- the icon appears on your home screen but tapping it produces an error or immediate crash.
• Enterprise or MDM restriction message -- a corporate-managed phone blocks the installation due to policy restrictions.

Device Compatibility Requirements

The EUDI Wallet relies on advanced security hardware built into modern smartphones. These requirements are not arbitrary -- they ensure your digital identity credentials are stored securely and cannot be extracted by malicious software.

iOS Requirements (iPhone)

For Apple devices, you need iOS 16 or later running on a compatible iPhone. This means the following devices are supported:

• iPhone 8 and iPhone 8 Plus (2017) -- minimum supported models
• iPhone X (2017) and all subsequent models
• iPhone SE (2nd generation, 2020) and iPhone SE (3rd generation, 2022)
• All iPhone 11, 12, 13, 14, 15, and 16 series models

The following devices are not supported even though they can run older versions of iOS: iPhone 7 and earlier, iPhone SE (1st generation), iPod touch (all generations). These devices lack the Secure Enclave capabilities required by the EUDI Wallet for cryptographic key storage.

To check your iOS version: open Settings > General > About and look at the "Software Version" line. To update: go to Settings > General > Software Update.

Android Requirements

For Android devices, you need Android 11 (API level 30) or later. In addition to the OS version, your device must have:

• NFC hardware -- required for reading the chip in your national identity card or passport.
• Hardware-backed Keystore -- a Trusted Execution Environment (TEE) or Secure Element (SE) for cryptographic key generation and storage. Most phones from major manufacturers (Samsung, Google Pixel, OnePlus, Xiaomi, etc.) released from 2019 onwards include this.
• Google Play Services -- the EUDI Wallet uses Google Play Services for device attestation. Devices without Google Play (such as certain Huawei models running HarmonyOS or EMUI without GMS) may not be able to run the wallet.
• SafetyNet / Play Integrity attestation -- rooted devices or those with unlocked bootloaders may fail the integrity check and be unable to install or run the wallet.

To check your Android version: open Settings > About Phone > Android Version. To check for NFC: go to Settings > Connected Devices > Connection Preferences and look for an NFC toggle.

Storage Space Requirements

The EUDI Wallet app itself is approximately 80-150MB depending on your platform and national wallet variant. However, you should have at least 500MB of free storage available because:

• The operating system needs temporary space during installation (unpacking, verification).
• The wallet creates a secure local database for your credentials.
• Cryptographic key material and cached certificate chains require additional space.
• Future updates need room to download alongside the existing version.

To free up space: delete unused apps, clear app caches (Settings > Storage on both iOS and Android), offload photos and videos to cloud storage, and remove old downloads.

Solving Network and Download Failures

Network problems are the most common cause of downloads that start but fail to complete. The app store needs a stable connection throughout the entire download process.

Step 1: Switch to Stable Wi-Fi

Mobile data connections can be interrupted by signal handoffs between cell towers, especially while moving. Connect to a reliable Wi-Fi network and try the download again. Avoid public Wi-Fi networks that require a login portal, as these can interrupt the download stream.

Step 2: Clear App Store Cache

A corrupted app store cache can cause repeated download failures:

• iOS: Open the App Store app, tap your profile icon at the top, then scroll down and tap on the app listing. Alternatively, tap any tab at the bottom of the App Store 10 times rapidly to force a cache clear, then search for the app again.
• Android: Go to Settings > Apps > Google Play Store > Storage > Clear Cache. Also clear the cache for Google Play Services and Download Manager.

Step 3: Sign Out and Sign Back In

Signing out of your app store account and signing back in can resolve authentication issues that block downloads:

• iOS: Settings > Apple ID (your name) > Media & Purchases > Sign Out. Then sign back in and retry.
• Android: Settings > Accounts > Google > Remove Account. Restart the phone, then re-add your Google account.

Step 4: Disable VPN and Check Firewalls

VPN connections can interfere with app store downloads, especially if the VPN routes traffic through a different country. Corporate or educational Wi-Fi networks may also have firewalls that block large downloads or specific app store domains. Temporarily disable any VPN and try a different network if you suspect firewall interference.

Enterprise and MDM Restrictions

If your phone is managed by your employer through a Mobile Device Management (MDM) system, you may encounter restrictions that prevent installing new apps. This is common on company-issued smartphones.

Symptoms of MDM restrictions include:

• A message saying "Your organisation does not allow this app" or similar.
• The install button is greyed out or missing.
• The app installs but immediately shows a "blocked by administrator" message.

Solutions for MDM-managed devices:

• Contact your IT department and request that the EUDI Wallet app be whitelisted. Since the wallet handles personal identity credentials, some organisations are adding it to their approved app lists.
• Use a personal phone instead. Given that the EUDI Wallet contains sensitive personal identity data, many users prefer to keep it on a personal device anyway.
• Ask your IT department whether they offer a "personal profile" or "BYOD container" that allows personal app installations alongside corporate ones.

Regional Availability and Country-Specific Wallets

Under the eIDAS 2.0 regulation, each EU member state is responsible for providing its own EUDI Wallet implementation. While these wallets are interoperable across borders, you typically need to download the wallet provided by your country of residence or citizenship.

This means:

• The app name may differ by country. For example, Germany's wallet may be listed under a different name than Italy's. Search for your country name plus "digital identity wallet" or "EUDI wallet".
• Not all countries have launched yet. The regulation requires full availability by the end of 2026, but some countries are ahead of schedule while others are still in pilot phase.
• Your app store region matters. If your App Store or Google Play account is set to a different country than where you live, the wallet may not appear in search results. Verify your store region in account settings.

Check the country-specific pages on this site for the latest information about availability and the official app name for your country.

Rooted or Jailbroken Device Issues

The EUDI Wallet performs device integrity checks during installation and at launch. This is a security requirement because the wallet stores legally binding identity credentials that must be protected against tampering.

If your device is rooted (Android) or jailbroken (iOS), the wallet may:

• Refuse to install entirely.
• Install but display an "insecure device" warning and refuse to store credentials.
• Fail the Google Play Integrity check or Apple Device Attestation.

The only reliable solution is to unroot/unjailbreak your device and restore it to its factory security state. This is by design -- a rooted device cannot guarantee the security of your identity credentials, and compromised credentials could lead to identity fraud.

Step-by-Step Installation Guide: iOS

1. Verify you are running iOS 16 or later: Settings > General > About.
2. Check available storage: Settings > General > iPhone Storage. Ensure at least 500MB free.
3. Connect to a stable Wi-Fi network.
4. Open the App Store.
5. Search for your national EUDI Wallet name (or "EUDI Wallet").
6. Tap Get, then authenticate with Face ID, Touch ID, or your Apple ID password.
7. Wait for the download and installation to complete. Do not switch apps during this process.
8. Once installed, open the app and follow the on-screen setup wizard.

Step-by-Step Installation Guide: Android

1. Verify you are running Android 11 or later: Settings > About Phone > Android Version.
2. Check available storage: Settings > Storage. Ensure at least 500MB free.
3. Confirm NFC is available: Settings > Connected Devices > Connection Preferences > NFC.
4. Connect to a stable Wi-Fi network.
5. Open the Google Play Store.
6. Search for your national EUDI Wallet name (or "EUDI Wallet").
7. Tap Install and accept any permission prompts.
8. Wait for the download and installation to complete.
9. Once installed, open the app and follow the on-screen setup wizard.

Warning: Never Sideload the EUDI Wallet

You should never download the EUDI Wallet APK from third-party websites or file-sharing services and install it manually (sideloading). Here is why:

• Security risk: A modified APK could contain malware designed to steal your identity credentials or personal data.
• No integrity verification: App stores verify the cryptographic signature of every app. Sideloaded apps bypass this check.
• No automatic updates: You would miss critical security patches and bug fixes.
• Attestation failure: A sideloaded wallet may fail device attestation checks, making your credentials invalid or unverifiable by relying parties.

Always use the official Apple App Store or Google Play Store. If the app does not appear in your store, it is not yet available in your region -- do not try to find alternative download sources.

Preventing Future Installation Issues

• Keep your phone updated. Enable automatic OS updates to ensure you always meet the latest requirements.
• Maintain sufficient free storage. A phone with less than 1GB free will frequently run into issues installing or updating apps.
• Enable automatic app updates. This ensures the wallet stays current and compatible with your OS version.
• Use official app stores only. Never download identity-related apps from unofficial sources.
• Keep your device in a factory-secure state. Do not root or jailbreak a phone you plan to use for digital identity.

When to Contact Support

If you have tried all the steps above and the app still will not install, it is time to seek help. Here is who to contact:

• For app-specific installation errors: Contact your national wallet provider. Each EU country has a designated support channel for its EUDI Wallet implementation. Look for contact details on your government's digital identity website.
• For App Store or Google Play issues: Contact Apple Support or Google Play Support, especially if other apps also fail to install.
• For MDM/enterprise restrictions: Contact your employer's IT department.
• For device hardware issues: If you suspect your phone's NFC or security hardware is defective, contact the phone manufacturer's support.

When contacting support, have the following information ready: your phone model and OS version, the exact error message you see, a screenshot of the error if possible, and the steps you have already tried. This helps support staff diagnose your issue faster.