.ovpn File Import

This example shows how to import an existing .ovpn configuration file into NetworkManager using nmrs.

Features

• Import .ovpn files with a single method call
• Builder approach for more control over the import
• Automatic handling of inline certificates
• Error handling for parse failures

One-Liner Import

The simplest way to import an .ovpn file:

use nmrs::NetworkManager;

#[tokio::main]
async fn main() -> nmrs::Result<()> {
    let nm = NetworkManager::new().await?;

    // Import with credentials
    nm.import_ovpn("client.ovpn", Some("alice"), Some("hunter2")).await?;
    println!("VPN imported and connected!");

    Ok(())
}

If the .ovpn file uses certificate-only authentication, pass None for username and password:

#![allow(unused)]
fn main() {
nm.import_ovpn("client.ovpn", None, None).await?;
}

Builder Approach

For more control over the import process, use OpenVpnBuilder:

use nmrs::{NetworkManager, OpenVpnBuilder};

#[tokio::main]
async fn main() -> nmrs::Result<()> {
    let nm = NetworkManager::new().await?;

    let config = OpenVpnBuilder::from_ovpn_file("client.ovpn")?
        .username("alice")
        .password("hunter2")
        .build()?;

    nm.connect_vpn(config).await?;
    println!("VPN connected!");

    Ok(())
}

The builder extracts remote, port, protocol, certificates, and other settings from the .ovpn file automatically.

Inline Certificates

Many .ovpn files embed certificates directly rather than referencing external files:

<ca>
-----BEGIN CERTIFICATE-----
MIIBxTCCAWugAwIBAgIJAJ...
-----END CERTIFICATE-----
</ca>

<cert>
-----BEGIN CERTIFICATE-----
MIICCzCCAZGgAwIBAgIRAP...
-----END CERTIFICATE-----
</cert>

<key>
-----BEGIN PRIVATE KEY-----
MIIEvgIBADANBgkqhkiG9w...
-----END PRIVATE KEY-----
</key>

from_ovpn_file handles these automatically — inline certificates are extracted and written to temporary files that NetworkManager can reference. No extra steps needed:

#![allow(unused)]
fn main() {
let config = OpenVpnBuilder::from_ovpn_file("inline-certs.ovpn")?
    .username("alice")
    .password("hunter2")
    .build()?;
}

Error Handling

Handle parse failures and missing fields gracefully:

#![allow(unused)]
fn main() {
use nmrs::{OpenVpnBuilder, ConnectionError};

fn import_config(path: &str) -> nmrs::Result<()> {
    let config = match OpenVpnBuilder::from_ovpn_file(path) {
        Ok(builder) => builder.build()?,
        Err(ConnectionError::InvalidConfig(msg)) => {
            eprintln!("Failed to parse {path}: {msg}");
            return Err(ConnectionError::InvalidConfig(msg));
        }
        Err(ConnectionError::NotFound) => {
            eprintln!("File not found: {path}");
            return Err(ConnectionError::NotFound);
        }
        Err(e) => {
            eprintln!("Import error: {e}");
            return Err(e);
        }
    };

    println!("Successfully parsed configuration");
    Ok(())
}
}

Common parse errors:

Complete Example

use nmrs::{NetworkManager, OpenVpnBuilder};

#[tokio::main]
async fn main() -> nmrs::Result<()> {
    let nm = NetworkManager::new().await?;

    let ovpn_path = std::env::args()
        .nth(1)
        .unwrap_or_else(|| "client.ovpn".into());

    let username = std::env::var("OVPN_USER").ok();
    let password = std::env::var("OVPN_PASS").ok();

    println!("Importing {ovpn_path}...");

    // Builder approach for maximum control
    let mut builder = OpenVpnBuilder::from_ovpn_file(&ovpn_path)?;

    if let Some(user) = &username {
        builder = builder.username(user);
    }
    if let Some(pass) = &password {
        builder = builder.password(pass);
    }

    let config = builder.build()?;
    nm.connect_vpn(config).await?;

    println!("Connected! Checking VPN info...");
    let vpns = nm.list_vpn_connections().await?;
    for vpn in &vpns {
        if vpn.active {
            println!("  Active: {} ({:?})", vpn.name, vpn.vpn_type);
        }
    }

    Ok(())
}

Next Steps

• OpenVPN Client Example — build OpenVPN config from scratch
• VPN Connections Guide — comprehensive VPN overview
• OpenVPN Setup — detailed OpenVPN configuration