🔒 pia.nix
Private Internet Access VPN Configurations & CLI for NixOS
Flake-based Installation
Add the pia.nix NixOS module to your system flake and configuration.
{
inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.05";
inputs.pia.url = "github:Fuwn/pia.nix";
inputs.pia.inputs.nixpkgs.follows = "nixpkgs";
outputs = { nixpkgs, pia, self }: {
nixosConfigurations.yourConfiguration = nixpkgs.lib.nixosSystem {
modules = [ pia.nixosModules."x86_64-linux".default ];
};
};
}
Module Set-up
Configure pia.nix in your NixOS configuration through the services.pia
attribute set.
{ config, ... }: {
services.pia.enable = true;
# Hardcoded username and password
services.pia.authUserPass.username = "hooty";
services.pia.authUserPass.password = "hunter42";
# Alternatively, you can use the `authUserPassFile` attribute if you are using
# a Nix secrets manager. Here's an example using sops-nix.
#
# The secret you provide to `authUserPassFile` should be a multiline string with
# a single username on the first line a single password on the second line.
services.pia.authUserPassFile = config.sops.secrets.pia.path;
}
Usage
# List all available VPN regions
pia list
# List all available VPN regions with fuzzy search support
pia search
# Activate VPN in a specific region
pia start japan
# Uses `pia search` to activate VPN in a specific region
pia start
# Deactivate VPN in a specific region
pia stop japan
# Uses `pia search` to deactivate VPN in a specific region
pia stop
Credits
This repository started off as a fork of ~rprospero/nixos-pia, which provided a starting point for populating OpenVPN with Private Internet Access' VPN configurations.