MARWAN docs NOC knowledge base
DocseduVPN

eduVPN at MARWAN

What eduVPN is, how researchers and staff in Morocco use it, and how an institution joins: through MARWAN's Secure Internet service or with its own Institute Access server.

Published Sami Ait Ali Oulahcen

What eduVPN is#

eduVPN is a VPN service built by and for research and education networks, run as a GÉANT service. Users install a free app, sign in with their institutional account, and get connected. There are no VPN passwords or configuration files to hand out.

It offers two kinds of service:

Service What it does Who runs the server
Secure Internet Protects users on untrusted networks (hotels, cafés, conferences) by sending their traffic through a trusted research network. A user can also connect through the server of another country. The national research network, MARWAN for Morocco
Institute Access Gives users access to their institution's internal network (intranet, licences, servers) from anywhere. Each institution, on its own server

Under the hood the server uses WireGuard (fast, the default) or OpenVPN over TCP when UDP is blocked. The apps exist for Windows, macOS, Linux, Android and iOS.

eduVPN in Morocco#

MARWAN coordinates eduVPN for Moroccan research and higher education.

Secure Internet. MARWAN runs the Moroccan Secure Internet server at eduvpn.marwan.ma. Users sign in through their institution's identity provider in the eduIDM federation. In November 2026 the institutions enabled for it are CNRST, MARWAN, ENIM, Ibn Tofail University (UIT), Sultan Moulay Slimane University (USMS) and Mohammed V University in Rabat (UM5).

Institute Access. These Moroccan servers are listed in the eduVPN apps (November 2026): MARWAN, CNRST, the Ministry of Higher Education, the Hassan II Academy of Science and Technology, Al Akhawayn University, Moulay Ismail University, Ibn Tofail University, Mohammed V University in Rabat and Cadi Ayyad University. The live list is at disco.eduvpn.org.

Connect as a user#

  1. Install the eduVPN app from app.eduvpn.org, or from your phone's app store.
  2. Open it and either:
    • type your institution's name and pick it under Institute Access, to reach your campus network, or
    • pick Secure Internet and your institution, to browse safely through MARWAN.
  3. Sign in with your usual institutional account in the browser window that opens.
  4. Press Connect.

The app remembers you, so next time it's one click. If it can't connect, try again from another network: some guest networks block VPNs.

Support for the Secure Internet service: eduvpn-support@marwan.ma. For Institute Access, contact your own institution's IT team.

Join as an institution#

There are two ways, and many institutions do both.

Offer Secure Internet to your users#

You don't need your own VPN server. You need:

  • an identity provider (IdP) registered in the eduIDM federation, and
  • to ask MARWAN at eduvpn-support@marwan.ma to enable your IdP for eduVPN. MARWAN will tell you which attributes your IdP must release.

Once enabled, your institution appears in the apps under Secure Internet, and your users can connect right away.

Run your own Institute Access server#

Run your own server when users need to reach internal resources. The eduVPN server is free software and installs with one script.

What you need

  • A clean VM with a supported OS. The eduVPN team recommends Debian 13. Rocky, Alma or RHEL 9 and 10, and Ubuntu 24.04 or 26.04, also work. See server OS support.
  • Static public IPv4 and IPv6 addresses, and a DNS name, for example vpn.example.ac.ma, already set as the server's hostname.
  • Open ports: tcp/80, tcp/443, tcp/1194 (OpenVPN) and udp/51820 (WireGuard).
  • A pool of addresses for VPN clients that is routed to the server, so that your internal systems see VPN users with their own range.

Install (as root, on Debian):

# hostnamectl set-hostname vpn.example.ac.ma
# apt -y install ca-certificates wget
# wget https://cdn.eduvpn.org/deploy/v3.tar.gz
# tar -xzf v3.tar.gz
# cd deploy
# ./deploy_debian.sh

The script asks for the server name and whether to install updates automatically each week. Say yes. At the end it prints a local vpn account and password you can use for a first test. On Rocky or Alma, use deploy_el.sh instead.

Then get a trusted TLS certificate (Let's Encrypt, or your HARICA certificate through MARWAN):

# ./acme_debian.sh
VPN clients reach the server itself by default

Out of the box there is no firewall between VPN clients and the VPN server, so connected users can reach its SSH port. Restrict it, as described in the eduVPN firewall guide.

Sign in with your institutional accounts. Replace the local accounts with your identity provider. The usual choices:

Your users are in… Use
An IdP in the eduIDM federation SAML: php-saml-sp
Keycloak or another OpenID Connect provider mod_auth_openidc
Active Directory or OpenLDAP LDAP
A RADIUS server RADIUS

For example, with Keycloak, after apt install libapache2-mod-auth-openidc, the portal's Apache site gets:

/etc/apache2/sites-available/vpn.example.ac.ma.conf
OIDCProviderMetadataURL https://idm.example.ac.ma/realms/EXAMPLE/.well-known/openid-configuration
OIDCClientID vpn.example.ac.ma
OIDCClientSecret <client secret from Keycloak>
OIDCRedirectURI https://vpn.example.ac.ma/vpn-user-portal/redirect_uri
OIDCCryptoPassphrase <output of: pwgen -s 64 -n 1>

<Location /vpn-user-portal>
    AuthType openid-connect
    Require valid-user
</Location>
# The apps use these without a browser session
<Location /vpn-user-portal/api>
    Require all granted
</Location>
<Location /vpn-user-portal/oauth/token>
    Require all granted
</Location>

Then set 'authModule' => 'OidcAuthModule' in /etc/vpn-user-portal/config.php and restart Apache.

Get listed in the apps.

  1. Test first: in the eduVPN app, type your server's name (vpn.example.ac.ma) and connect.
  2. Check your TLS setup (TLS 1.3, complete chain) with SSL Labs.
  3. Subscribe your team to the eduvpn-deploy mailing list.
  4. Sign the eduVPN policy compliance statement and send the registration request, as described in server registration. Copy eduvpn-support@marwan.ma and MARWAN will help you through it.

Registered servers must keep their OS current and install updates at least every two weeks, which the weekly automatic updates take care of.

Further reading#