aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: d36c63dca20d205283c99bd46f12bf73de1acfe7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# Private Internet Access VPN Configurations for NixOS

This repository is a fork of [~rprospero/nixos-pia](https://git.sr.ht/~rprospero/nixos-pia)
that has been updated and is being actively maintained.

## Flake-based Installation

Add the `nixos-pia` module to your system flake and configuration.

```nix
{
  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.05";
  inputs.pia.url = "github:Fuwn/nixos-pia";
  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 `nixos-pia` in your NixOS configuration.

```nix
{ config, ... }: {
  services.pia.enable = true;
  services.pia.authUserPass.username = "hooty";
  services.pia.authUserPass.password = "hunter42";
}
```

## Usage

```sh
# Activate VPN in a specific region
sudo systemctl start openvpn-japan

# Deactivate VPN
sudo systemctl stop openvpn-japan

# List all available VPN regions
ls /etc/systemd/system/ | grep openvpn

# List all available VPN regions with fuzzy search support
ls /etc/systemd/system/ | awk '/openvpn/ { print $1 }' | fzf
```