summaryrefslogtreecommitdiff
path: root/docs/branding.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/branding.rst')
-rw-r--r--docs/branding.rst63
1 files changed, 63 insertions, 0 deletions
diff --git a/docs/branding.rst b/docs/branding.rst
new file mode 100644
index 0000000..6c7a0d9
--- /dev/null
+++ b/docs/branding.rst
@@ -0,0 +1,63 @@
+BitmaskVPN Branding Procedure
+================================================================================
+
+This document contains the instructions to generate a custom build of the
+Desktop BitmaskVPN app for a given provider.
+
+Configure
+--------------------------------------------------------------------------------
+
+All the needed information to vendorize BitmaskVPN are contained in an external
+folder, where you will place the connection details to your own provider and
+any asset that you want to customize. To start a new vendoring project, you need
+to initialize a new repo for your provider:
+
+ export VENDOR_PATH=../leapvpn-myprovider-pkg
+ make vendor_init
+
+Follow the directions in the output of the above command. Basically you need to
+configure your provider CA certificate, and some graphical assets:
+
+ * Copy your provider CA certificate to the same folder: '<provider>-ca.crt'
+ * Check the list of assets at 'assets/FILES.Readme'.
+
+You can validate your configuration:
+
+ VENDOR_PATH=../myprovider-vpn-pkg vendor_check
+
+This will fetch your provider's CA against the one you have configured. If you
+want to skip the online check, set the `SKIP_CACHECK` to "yes".
+
+Checkout the source
+--------------------------------------------------------------------------------
+
+ git clone https://0xacab.org/leap/bitmask-vpn
+ cd bitmask-vpn
+ git pull --tags
+
+
+Build & package
+--------------------------------------------------------------------------------
+
+NOTE: Some of the following scripts need network access, since they will check
+whether the configuration published by your provider matches what is configured
+before the build. If you want to skip this check, pass `SKIP_CACHECK=yes`
+
+Run::
+
+ VENDOR_PATH=../myprovider-vpn-pkg make vendor
+
+Then you can build the binaries for some quick manual testing::
+
+ make build
+
+Now you can build the installer for your host platform::
+
+ make build_installer
+
+Previously we had a cross-compilation setup in place. Cross compilation will be added back in the future.
+
+For debian and snap packages (FIXME -- WORK IN PROGRESS):
+
+ make debian
+ make snap