User:Jackrosenberg/Pangolin: Difference between revisions

m SigmaSquadron moved page User:Jackrosenberg/pangolin to User:Jackrosenberg/Pangolin: Misspelled title
m Env file explanation (will do more tomorrow)
 
(One intermediate revision by one other user not shown)
Line 3: Line 3:


== Prerequisites ==
== Prerequisites ==
Pangolin requires setup outside of NixOS, at the very least the user needs:TODO
To use pangolin you'll need a domain and a public accessible static IP address.
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.
 
See the [https://docs.pangolin.net/self-host/quick-install#prerequisites setup docs] for more information.


== Installation ==
== Installation ==
Line 24: Line 25:
       };
       };
     };
     };
     letsEncryptEmail = "pangolin@${baseDomain}"; # an email you have access to
    baseDomain = "example.com";
     letsEncryptEmail = "john_doe@proton.me"; # an email you have access to
     openFirewall = true;  
     openFirewall = true;  
     environmentFile = "/etc/nixos/secrets/pangolin.env";
     environmentFile = "/etc/nixos/secrets/pangolin.env";
Line 30: Line 32:


}
}
</nowiki>
}}
=== EnvironmentFile ===
Pangolin requires a [https://docs.pangolin.net/manage/sites/credentials#secret server secret], used for handshake authentication. Additionally, you may provide the setup token as shown below, which saves the trouble of finding it in logs with <code> journalctl -eu pangolin | grep token</code>. Naturally, don't use these secrets.
{{file|pangolin.env|env|
<nowiki>
SERVER_SECRET=2w34etdr546rftygu8678yuhihg87objpvfctoyvihdr4u6
PANGOLIN_SETUP_TOKEN=123456789abcdefg
</nowiki>
</nowiki>
}}
}}