Moving to Spain as a developer: the visa routes, and the government tech you will have to fight

Papeles en Orden — Sat, 17 Oct 2026 14:04:10 +0000

If you write software and are thinking about moving to Spain, you will probably research the legal side first. Oddly, that tends to be the smoother part. What eats your weekends is the tooling: certificates stuck in one browser profile, a signing app that talks to a web page through a local protocol handler, and an appointment system with no appointments.

This post covers the routes that tend to fit developers, then the government tech you will need to get working. It is general information, not legal advice. Rules change, consulates interpret them differently, and one detail of your case can change the answer.

The routes that usually fit developers

International teleworking (the "digital nomad" route). Introduced by Ley 28/2022, which amended Ley 14/2013, it is for people working remotely for a company outside Spain, or freelancers whose clients are mostly abroad. You apply for a visa at a consulate or, in some situations, for a residence authorisation from inside Spain if you are already there legally. The Unidad de Grandes Empresas y Colectivos Estratégicos (UGE) handles it, with much shorter deadlines than the general immigration offices. Expect to show a real, existing relationship with your employer or clients, qualifications or professional experience, and enough income. The UGE measures income as a multiple of the Spanish minimum wage, plus extra per family member, so check the current figure before applying.

Highly qualified professional. If a Spanish company is hiring you for a qualified role, this is often faster than the general work permit. It also goes through the UGE, and the employer usually drives the application.

EU family member. If your spouse, registered partner or parent holds an EU, EEA or Swiss passport, there is a separate route under the EU regime. When it applies it is usually the quickest, and people often miss that they qualify.

Students. Some developers arrive on a study stay and later switch to a work authorisation. That switch has its own timing, and doing it late is an expensive mistake.

There is an overview of every route, and the situation each one starts from, on this residence routes page (in Spanish). Settle which one fits you before you collect a single document.

Your NIE comes first

Almost everything below depends on the NIE, your foreigner identification number. It is only an identifier and does not let you live or work in Spain; the physical card, the TIE, is a separate thing. You need the NIE before you can get a digital certificate or register for Cl@ve, so expect a chicken-and-egg phase where nothing works online yet. During that phase, things get done in person or through a representative filing for you.

The FNMT digital certificate

The FNMT (the Spanish Royal Mint) issues a free personal digital certificate to any adult with an NIE. You do not need a Spanish DNI. It is an X.509 certificate with a private key, and it acts as your login and signature on almost every government site. What trips people up:

The key is generated on your machine. You install the FNMT's configuration software, request online, get a code by email, prove your identity, then download. The download must happen on the same device where you made the request, because that is where the private key was created.
Identity checks for foreigners are usually in person. Video identification needs a Spanish electronic DNI, so foreigners usually go to an accreditation office, some of which need an appointment.
Back it up immediately. Export a .p12/.pfx with a strong password. Requesting a new certificate revokes the old one.
Know which store it lives in. Firefox has its own store. On Linux, Chromium-based browsers usually read the NSS database in your home directory; on Windows and macOS, the system store. "No certificate found" usually means it is in a store your browser isn't reading.
Check the expiry date. Current certificates carry a fixed end date rather than a set lifetime, so look at the details after installing.

The full process, including what to bring to the office if you are an EU or non-EU national, is in this guide to the FNMT certificate for foreigners (in Spanish).

Cl@ve

Cl@ve is the shared login for public administration sites, based on passwords and SMS PINs rather than certificates. To register as a foreigner you need your NIE, the document that proves it (TIE, EU registration certificate or residence permit) and your passport. One mobile number can only be linked to one NIE or DNI.

Automatic video ID in the app is, for now, only for Spanish DNI holders. Foreigners use a postal invitation letter, a video call or an in-person office, and the remote options only give the basic level. If you already have the FNMT certificate, you can register through the tax agency's site instead.

AutoFirma and the sede electrónica

The sede electrónica is where you file applications, track your file and request appointments. Signing is usually handed off to AutoFirma, a desktop app the page calls through a custom URL scheme. When signing fails, the usual causes are:

AutoFirma isn't installed, or was installed before the browser and never registered its protocol handler. Reinstalling fixes this more often than it should.
Browser hardening or an extension blocks the local handoff. Try a clean profile.
The certificate is in a store AutoFirma doesn't read.

Turn on electronic notifications and check them: a notification can count as delivered even if you never open it, and deadlines run from there. And everything on the official sede is free, so a lookalike site charging to "file" or "get an appointment" is selling you nothing.

Cita previa, and why you should not write a bot

Sooner or later you need an in-person appointment, at least for fingerprints and the TIE. In Madrid the system is saturated, and every developer's first thought is to script it.

Don't. Automated grabbing of slots is part of what feeds the resale market for appointments that are free, and an appointment obtained irregularly can complicate your application. What helps is duller:

Check whether your procedure can be filed online at all. The best appointment is the one you don't need.
Book the right type at the right body. In Madrid, filing is at the immigration office, but fingerprints and the TIE go through the National Police.
Choose any office in the province, not the nearest.
Try at different times; cancelled slots reappear unpredictably.
Have every document ready so you can take a slot immediately.

Which Madrid office does what is on this page about cita previa in Madrid (in Spanish).

A sensible order of operations

Settle which route fits you before you gather any paperwork.
Get your NIE through that route.
Get the FNMT certificate, back it up, and note its expiry date.
Register for Cl@ve, using the certificate if you have it.
Install AutoFirma, then test a signature on something low-stakes.
Turn on electronic notifications and put a recurring reminder in your calendar to check them.

Treat it like a new dev environment: get each dependency working alone before chaining them.

This post was written by Papeles en Orden, an immigration-paperwork practice in Madrid led by a lawyer registered with the Madrid Bar (ICAM).

DEV Community: Papeles en Orden