Jump to content

User:Jackrosenberg/Pangolin: Difference between revisions

From Official NixOS Wiki
WIP pangolin
 
m wip 2
Line 1: Line 1:
[https://pangolin.net {{PAGENAME}}] is an identity-aware VPN and proxy for remote access to anything, anywhere.
[[File:pangolin_logo.png|thumb|The Pangolin Logo]]
<strong>[https://pangolin.net Pangolin]</strong> is an identity-aware VPN and proxy for remote access to anything, anywhere.
 
== Prerequisites ==
Pangolin requires setup outside of NixOS, at the very least the user needs:TODO
a domain and a machine with a publicly accessible static IP address. See the [https://docs.pangolin.net/self-host/quick-install#prerequisites setup docs] for more information.


== Installation ==
== Installation ==
To install Pangolin, add the following to your NixOS configuration:
TODO
More options are available: {{nixos:option|services.pangolin.}}
 
== Sample setups ==
 
==== Minimal setup <code>configuration.nix</code> ====


<syntaxhighlight lang="nix">
{{file|configuration.nix|nix|
services.pangolin = {
<nowiki>
  enable = true;
{
};
  services.pangolin = {
    enable = true;
    # this part is technically not needed,
    # but omitting it will allow
    # ANYONE TO CREATE ACCOUNTS AND
    # ORGANIZATIONS ON YOUR PANGOLIN INSTANCE
    settings = {
      flags = {
        disable_signup_without_invite = true;
        disable_user_create_org = true;
      };
    };
    letsEncryptEmail = "pangolin@${baseDomain}"; # an email you have access to
    openFirewall = true;
    environmentFile = "/etc/nixos/secrets/pangolin.env";
  };


</syntaxhighlight>
}
</nowiki>
}}

Revision as of 14:30, 30 January 2026

The Pangolin Logo

Pangolin is an identity-aware VPN and proxy for remote access to anything, anywhere.

Prerequisites

Pangolin requires setup outside of NixOS, at the very least the user needs:TODO a domain and a machine with a publicly accessible static IP address. See the setup docs for more information.

Installation

TODO

❄︎ configuration.nix
{
  services.pangolin = {
    enable = true;
    # this part is technically not needed,
    # but omitting it will allow 
    # ANYONE TO CREATE ACCOUNTS AND 
    # ORGANIZATIONS ON YOUR PANGOLIN INSTANCE
    settings = {
      flags = {
        disable_signup_without_invite = true;
        disable_user_create_org = true;
      };
    };
    letsEncryptEmail = "pangolin@${baseDomain}"; # an email you have access to
    openFirewall = true; 
    environmentFile = "/etc/nixos/secrets/pangolin.env";
  };

}