From a6ebfb521dbc53eb9222d180f7fabc1a76cdf539 Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Wed, 21 Feb 2024 11:20:57 +0100 Subject: [PATCH 1/7] remove redundant part --- .../dev-portal/src/nymvpn/gui-linux.md | 46 ++------------ .../dev-portal/src/nymvpn/old-gui-mac.md | 61 +++++++++++++++++++ 2 files changed, 66 insertions(+), 41 deletions(-) create mode 100644 documentation/dev-portal/src/nymvpn/old-gui-mac.md diff --git a/documentation/dev-portal/src/nymvpn/gui-linux.md b/documentation/dev-portal/src/nymvpn/gui-linux.md index 01c2b0438d..55c0b4bbae 100644 --- a/documentation/dev-portal/src/nymvpn/gui-linux.md +++ b/documentation/dev-portal/src/nymvpn/gui-linux.md @@ -26,55 +26,19 @@ tar -xvf # for example # tar -xvf nym-vpn-desktop_0.0.4_ubuntu-22.04_x86_64.tar.gz ``` -2. Make executable by running: -```sh -# possibly you may have to cd into a sub-directory -chmod u+x -``` -5. Create Sandbox environment config file by saving [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) as `sandbox.env` in the same directory as your NymVPN binaries by running: -```sh -curl -o sandbox.env -L https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env -``` - -## Run NymVPN - -**For NymVPN to work, all other VPNs must be switched off!** At this alpha stage of NymVPN, the network connection (wifi) must be reconnected after or in between the testing rounds. - -Make sure your terminal is open in the same directory as your `nym-vpn-cli` binary. - -1. Go to [nymvpn.com/en/alpha](https://nymvpn.com/en/alpha) to get the entire command with all the needed arguments' values and your wireguard private key for testing purposes -2. Run it as root with `sudo` - the command will look like this with specified arguments: -```sh -sudo ./nym-vpn-cli -c ./sandbox.env --entry-gateway-id --exit-router-address --enable-wireguard --private-key --wg-ip -``` -3. To choose different Gateways, visit [nymvpn.com/en/alpha/api/gateways](https://nymvpn.com/en/alpha/api/gateways) and pick one -4. See all possibilities in [command explanation](#cli-commands-and-options) section below - -In case of errors, see [troubleshooting section](troubleshooting.md). - -### CLI Commands and Options - -The basic syntax of `nym-vpn-cli` is: -```sh -sudo ./nym-vpn-cli -c ./sandbox.env --entry-gateway-id --exit-router-address --enable-wireguard --private-key --wg-ip -``` -* To choose different Gateways, visit [nymvpn.com/en/alpha/api/gateways](https://nymvpn.com/en/alpha/api/gateways) -* To see all possibilities run with `--help` flag: -```sh -./nym-vpn-cli --help -``` 4. If you prefer to run `.AppImage` make executable by running: ```sh -chmod u+x ./appimage/nym-vpn_0.0.2_amd64.AppImage +# make sure you cd into the right sub-directory after extraction +chmod u+x ./appimage/nym-vpn_0.0.4_amd64.AppImage ``` 5. If you prefer to use the `.deb` version for installation (works on Debian based Linux only), open terminal in the same directory and run: ```sh cd deb -sudo dpkg -i ./nym-vpn_0.0.3_amd64.deb +sudo dpkg -i ./nym-vpn_0.0.4_amd64.deb # or -sudo apt-get install -f ./nym-vpn_0.0.3_amd64.deb +sudo apt-get install -f ./nym-vpn_0.0.4_amd64.deb ``` ### Configuration @@ -104,7 +68,7 @@ Open terminal and run: ```sh # .AppImage must be run from the same directory as the binary -sudo -E ./nym-vpn_0.033_amd64.AppImage +sudo -E ./nym-vpn_0.0.4_amd64.AppImage # .deb installation shall be executable from anywhere as sudo -E nym-vpn diff --git a/documentation/dev-portal/src/nymvpn/old-gui-mac.md b/documentation/dev-portal/src/nymvpn/old-gui-mac.md new file mode 100644 index 0000000000..ba74a23f41 --- /dev/null +++ b/documentation/dev-portal/src/nymvpn/old-gui-mac.md @@ -0,0 +1,61 @@ +# NymVPN alpha - Desktop: Guide for Mac OS + +```admonish info +NymVPN is an experimental software and it's for [testing](./testing.md) purposes only. All users testing the client are expected to sign GDPR Information Sheet and Consent Form (shared at the workshop) so we use their results to improve the client, and submit the form [*NymVPN User research*]({{nym_vpn_form_url}}) with the testing results. +``` + +## Preparation + +> Any syntax in `<>` brackets is a user's/version unique variable. Exchange with a corresponding name without the `<>` brackets. + +### Installation + +1. Create a directory `~/nym-vpn-latest` +```sh +mkdir -p "$HOME/nym-vpn-latest" +``` +2. Open Github [releases page]({{nym_vpn_latest_binary_url}}) and download the binary for MacOS +3. Verify sha hash of your downloaded binary with the one listed on the [releases page]({{nym_vpn_latest_binary_url}}). You can use a simple `shasum` command and compare strings (ie with Python) or run in the same directory the following command, exchanging `` with the one of your binary, like in the example: +```sh +echo "" | shasum -a 256 -c + +# choose a correct one according to your binary, this is just an example +# echo "da4c0bf8e8b52658312d341fa3581954cfcb6efd516d9a448c76d042a454b5df nym-vpn-desktop_0.0.3_macos_x86_64.zip" | shasum -a 256 -c +``` +4. Extract files: +```sh +tar -xvf +# for example +# tar -xvf nym-vpn-desktop_0.0.4_macos_aarch64.tar.gz +``` +5. Move to the application directory and make executable +```sh +cd "macos/nym-vpn.app/Contents/MacOS" + +chmod u+x nym-vpn +``` +6. Move `nym-vpn` to your `~/nym-vpn-latest` directory +```sh +mv nym-vpn "$HOME/nym-vpn-latest" +``` + +### Configuration + +7. Create the configuration file by opening a text editor and saving the lines below as `config.toml` in the same directory `~/nym-vpn-latest` +```toml +env_config_file = ".env" +``` +8. Create testnet configuration file by saving [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) as `.env` in the same directory `~/nym-vpn-latest` +```sh +curl -L "https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env" -o "$HOME/nym-vpn-latest/.env" +``` +## Run NymVPN + +**For NymVPN to work, all other VPNs must be switched off!** At this alpha stage of NymVPN, the network connection (wifi) must be reconnected after or in between the testing rounds. + +Run: +```sh +sudo -E $HOME/nym-vpn-latest/nym-vpn +``` + +In case of errors check out the [troubleshooting](troubleshooting.html#installing-gui-on-macos-not-working) section. From 32c897f78915fc07d95225276dfad75dcc4cfee5 Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Wed, 21 Feb 2024 11:33:51 +0100 Subject: [PATCH 2/7] add mac desktop manual setup --- .../dev-portal/src/nymvpn/gui-mac.md | 29 +++++++++++++++---- 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/documentation/dev-portal/src/nymvpn/gui-mac.md b/documentation/dev-portal/src/nymvpn/gui-mac.md index ba74a23f41..5829b4277e 100644 --- a/documentation/dev-portal/src/nymvpn/gui-mac.md +++ b/documentation/dev-portal/src/nymvpn/gui-mac.md @@ -14,38 +14,55 @@ NymVPN is an experimental software and it's for [testing](./testing.md) purposes ```sh mkdir -p "$HOME/nym-vpn-latest" ``` -2. Open Github [releases page]({{nym_vpn_latest_binary_url}}) and download the binary for MacOS -3. Verify sha hash of your downloaded binary with the one listed on the [releases page]({{nym_vpn_latest_binary_url}}). You can use a simple `shasum` command and compare strings (ie with Python) or run in the same directory the following command, exchanging `` with the one of your binary, like in the example: + +2. Open Github [releases page]({{nym_vpn_latest_binary_url}}) and download the binary for your version of MacOS + +3. Recommended (skip to next point if you don't want to verify): Verify sha hash of your downloaded binary with the one listed on the [releases page]({{nym_vpn_latest_binary_url}}). You can use a simple `shasum` command and compare strings (ie with Python) or run in the same directory the following command, exchanging `` with the one of your binary, like in the example: ```sh echo "" | shasum -a 256 -c # choose a correct one according to your binary, this is just an example # echo "da4c0bf8e8b52658312d341fa3581954cfcb6efd516d9a448c76d042a454b5df nym-vpn-desktop_0.0.3_macos_x86_64.zip" | shasum -a 256 -c ``` + 4. Extract files: ```sh tar -xvf # for example # tar -xvf nym-vpn-desktop_0.0.4_macos_aarch64.tar.gz ``` -5. Move to the application directory and make executable + +5. Move to the application content directory: ```sh cd "macos/nym-vpn.app/Contents/MacOS" +# if it didn't work, try +cd "/Applications/nym-vpn.app/Contents/MacOS/" +``` + +6. Make executable +```sh chmod u+x nym-vpn ``` -6. Move `nym-vpn` to your `~/nym-vpn-latest` directory + +7. Move `nym-vpn` to your `~/nym-vpn-latest` directory ```sh mv nym-vpn "$HOME/nym-vpn-latest" ``` +Here you are basically done with the installation. NymVPN alpha version runs over Nym testnet (called sandbox), we need to do a little configuration: + ### Configuration -7. Create the configuration file by opening a text editor and saving the lines below as `config.toml` in the same directory `~/nym-vpn-latest` +8. Create the application configuration file by opening a text editor and saving the lines below as `config.toml` in the same directory `~/nym-vpn-latest` ```toml env_config_file = ".env" ``` -8. Create testnet configuration file by saving [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) as `.env` in the same directory `~/nym-vpn-latest` +Alternatively do it via a simple command: +```sh +echo "env_config_file = .env" > "$HOME/nym-vpn-latest/config.toml" +``` +9. Create testnet configuration file by saving [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) as `.env` in the same directory `~/nym-vpn-latest` ```sh curl -L "https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env" -o "$HOME/nym-vpn-latest/.env" ``` From e83be64a523f5a3be20f88954c5e83df2a8c0f08 Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Thu, 22 Feb 2024 06:23:18 +0100 Subject: [PATCH 3/7] mac desktop manual steps --- .../dev-portal/src/nymvpn/gui-mac.md | 42 ++++++++++++------- 1 file changed, 26 insertions(+), 16 deletions(-) diff --git a/documentation/dev-portal/src/nymvpn/gui-mac.md b/documentation/dev-portal/src/nymvpn/gui-mac.md index 5829b4277e..4abba4a4e6 100644 --- a/documentation/dev-portal/src/nymvpn/gui-mac.md +++ b/documentation/dev-portal/src/nymvpn/gui-mac.md @@ -10,14 +10,16 @@ NymVPN is an experimental software and it's for [testing](./testing.md) purposes ### Installation + -2. Open Github [releases page]({{nym_vpn_latest_binary_url}}) and download the binary for your version of MacOS +1. Open Github [releases page]({{nym_vpn_latest_binary_url}}) and download the binary for your version of MacOS -3. Recommended (skip to next point if you don't want to verify): Verify sha hash of your downloaded binary with the one listed on the [releases page]({{nym_vpn_latest_binary_url}}). You can use a simple `shasum` command and compare strings (ie with Python) or run in the same directory the following command, exchanging `` with the one of your binary, like in the example: +2. Recommended (skip this point if you don't want to verify): Verify sha hash of your downloaded binary with the one listed on the [releases page]({{nym_vpn_latest_binary_url}}). You can use a simple `shasum` command and compare strings (ie with Python) or run in the same directory the following command, exchanging `` with the one of your binary, like in the example: ```sh echo "" | shasum -a 256 -c @@ -25,13 +27,13 @@ echo "" | shasum -a 256 -c # echo "da4c0bf8e8b52658312d341fa3581954cfcb6efd516d9a448c76d042a454b5df nym-vpn-desktop_0.0.3_macos_x86_64.zip" | shasum -a 256 -c ``` -4. Extract files: +3. Extract the downloaded file manually or by a command: ```sh tar -xvf # for example # tar -xvf nym-vpn-desktop_0.0.4_macos_aarch64.tar.gz ``` - + +4. Mount the `.dmg` image you extracted by double clicking on it -Here you are basically done with the installation. NymVPN alpha version runs over Nym testnet (called sandbox), we need to do a little configuration: + +NymVPN alpha version runs over Nym testnet (called sandbox), a little extra configuration is needed for the application to work. ### Configuration -8. Create the application configuration file by opening a text editor and saving the lines below as `config.toml` in the same directory `~/nym-vpn-latest` +To test NymVPN alspha two configuration files are needed. An environment config file `sandbox.env` and `config.toml` file pointing the application to run over the testnet environment. + +5. Create testnet configuration file: Open a text editor, copy-paste [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) and save it as `sandbox.env` in `/Applications/nym-vpn.app/Contents/MacOS/`. Alternatively use this command: +```sh +curl -L "https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env" -o "/Applications/nym-vpn.app/Contents/MacOS/sandbox.env" +``` + +6. Create application configuration file: Open a text editor, copy-paste the line below and save as `config.toml` in the same directory `/Applications/nym-vpn.app/Contents/MacOS/` ```toml -env_config_file = ".env" +env_config_file = "sandbox.env" ``` -Alternatively do it via a simple command: +Alternatively do it by using this command: ```sh -echo "env_config_file = .env" > "$HOME/nym-vpn-latest/config.toml" -``` -9. Create testnet configuration file by saving [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) as `.env` in the same directory `~/nym-vpn-latest` -```sh -curl -L "https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env" -o "$HOME/nym-vpn-latest/.env" +echo "env_config_file = sandbox.env" > /Applications/nym-vpn.app/Contents/MacOS//config.toml ``` ## Run NymVPN @@ -72,7 +79,10 @@ curl -L "https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env" Run: ```sh -sudo -E $HOME/nym-vpn-latest/nym-vpn +sudo /Applications/nym-vpn.app/Contents/MacOS/nym-vpn + +# If it didn't start try to run with -E flag +sudo -E /Applications/nym-vpn.app/Contents/MacOS/nym-vpn ``` -In case of errors check out the [troubleshooting](troubleshooting.html#installing-gui-on-macos-not-working) section. +In case of errors check out the [troubleshooting](troubleshooting.md#running-gui-failed-due-to-toml-parse-error) section. From ffb053fe4abe6032502bea72df32d8a53a77ee09 Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Thu, 22 Feb 2024 06:28:12 +0100 Subject: [PATCH 4/7] desktop auto script update --- documentation/dev-portal/src/nymvpn/gui.md | 20 +++++--------------- 1 file changed, 5 insertions(+), 15 deletions(-) diff --git a/documentation/dev-portal/src/nymvpn/gui.md b/documentation/dev-portal/src/nymvpn/gui.md index 2f06b22dd9..1a027f4f5c 100644 --- a/documentation/dev-portal/src/nymvpn/gui.md +++ b/documentation/dev-portal/src/nymvpn/gui.md @@ -8,30 +8,20 @@ Our alpha testing round is done with participants at live workshop events. This This is the alpha version of NymVPN desktop application (GUI). A demo of how the client will look like for majority of day-to-day users. For qualitative testing the [CLI](cli.md) is a necessity but to run the GUI holds the same importance as it provides the user with an experience of the actual app and the developers with a valuable feedback from the users. -Follow the simple [automated script](#automated-script-for-gui-installation) below to install and run NymVPN GUI. If you prefer to do a manual setup follow the steps in the guide for [Linux](gui-linux.md). +Follow the simple [automated script](#automated-script-for-gui-installation) below to install and run NymVPN GUI. If the script didn't work for yur distribution or you prefer to do a manual setup follow the steps in the guide for [Linux](gui-linux.md) or [MacOS](gui-mac.md) . Visit NymVPN alpha latest [release page]({{nym_vpn_latest_binary_url}}) to check sha sums or download the binaries directly. ## Automated Script for GUI Installation -We wrote a [script](https://gist.github.com/serinko/e0a9f7ff3d79e974ec6f6783caa1137e) which does download of dependencies and the application, sha256 verification, extraction, installation and configuration for Linux and MacOS users automatically following the steps below: +We wrote a [script](https://gist.github.com/serinko/e0a9f7ff3d79e974ec6f6783caa1137e) which does download of dependencies and the application, sha256 verification, extraction, installation and configuration for Linux and MacOS users automatically. Turn off all VPNs and follow the steps below. -1. Open a terminal window in a directory where you want the script and NymVPN binary be downloaded and run +1. Open a terminal window in a directory where you want the script to be downloaded and run ```sh -curl -o nym-vpn-desktop-install-run.sh -L https://gist.githubusercontent.com/serinko/e0a9f7ff3d79e974ec6f6783caa1137e/raw/227c8c348a1e58f68cb500e4504b22412177c680/nym-vpn-desktop-install-run.sh +curl -o nym-vpn-desktop-install-run.sh -L https://gist.githubusercontent.com/serinko/e0a9f7ff3d79e974ec6f6783caa1137e/raw/227c8c348a1e58f68cb500e4504b22412177c680/nym-vpn-desktop-install-run.sh && chmod u+x nym-vpn-desktop-install-run.sh && sudo -E ./nym-vpn-desktop-install-run.sh ``` -2. Make the script executable -```sh -chmod u+x nym-vpn-desktop-install-run.sh -``` - -3. Start the script, turn off any VPN and run -```sh -sudo -E ./nym-vpn-desktop-install-run.sh -``` - -4. Follow the prompts in the program +2. Follow the prompts in the program To start the application again, reconnect your wifi and run ```sh From 90680ceb16c2d3b95796958b5b453a4fb2ffd540 Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:14:14 +0100 Subject: [PATCH 5/7] add moving application step --- documentation/dev-portal/src/nymvpn/gui-mac.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/dev-portal/src/nymvpn/gui-mac.md b/documentation/dev-portal/src/nymvpn/gui-mac.md index 4abba4a4e6..769e3040da 100644 --- a/documentation/dev-portal/src/nymvpn/gui-mac.md +++ b/documentation/dev-portal/src/nymvpn/gui-mac.md @@ -51,7 +51,7 @@ chmod u+x nym-vpn mv nym-vpn "$HOME/nym-vpn-latest" ``` --> -4. Mount the `.dmg` image you extracted by double clicking on it +4. Mount the `.dmg` image you extracted by double clicking on it and move it (drag it) to your `/Application` folder NymVPN alpha version runs over Nym testnet (called sandbox), a little extra configuration is needed for the application to work. From bfac3e0b899c91323ce281eff76f043121e8e44b Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:23:00 +0100 Subject: [PATCH 6/7] add gui-mac to summary --- documentation/dev-portal/src/SUMMARY.md | 1 + documentation/dev-portal/src/nymvpn/gui-linux.md | 10 +++++++--- documentation/dev-portal/src/nymvpn/gui-mac.md | 2 +- 3 files changed, 9 insertions(+), 4 deletions(-) diff --git a/documentation/dev-portal/src/SUMMARY.md b/documentation/dev-portal/src/SUMMARY.md index e98304dea0..db47668d2f 100644 --- a/documentation/dev-portal/src/SUMMARY.md +++ b/documentation/dev-portal/src/SUMMARY.md @@ -21,6 +21,7 @@ - [NymVPN alpha](nymvpn/intro.md) - [GUI](nymvpn/gui.md) - [Linux](nymvpn/gui-linux.md) + - [MacOS](nymvpn/gui-mac.md) - [CLI](nymvpn/cli.md) - [Linux](nymvpn/cli-linux.md) - [MacOS](nymvpn/cli-mac.md) diff --git a/documentation/dev-portal/src/nymvpn/gui-linux.md b/documentation/dev-portal/src/nymvpn/gui-linux.md index 55c0b4bbae..713142c2eb 100644 --- a/documentation/dev-portal/src/nymvpn/gui-linux.md +++ b/documentation/dev-portal/src/nymvpn/gui-linux.md @@ -13,7 +13,7 @@ NymVPN is an experimental software and it's for [testing](./testing.md) purposes ### Installation 1. Open Github [releases page]({{nym_vpn_latest_binary_url}}) and download the binary for Debian based Linux -2. Verify sha hash of your downloaded binary with the one listed on the [releases page]({{nym_vpn_latest_binary_url}}). You can use a simple `shasum` command and compare strings (ie with Python) or run in the same directory the following command, exchanging `` with the one of your binary, like in the example: +2. Required (if you don't want to check shasum, skip this point): Verify sha hash of your downloaded binary with the one listed on the [releases page]({{nym_vpn_latest_binary_url}}). You can use a simple `shasum` command and compare strings (ie with Python) or run in the same directory the following command, exchanging `` with the one of your binary, like in the example: ```sh echo "" | shasum -a 256 -c @@ -41,18 +41,22 @@ sudo dpkg -i ./nym-vpn_0.0.4_amd64.deb sudo apt-get install -f ./nym-vpn_0.0.4_amd64.deb ``` +NymVPN alpha version runs over Nym testnet (called sandbox), a little extra configuration is needed for the application to work. + ### Configuration +To test NymVPN alpha we must create two configuration files: an environment config file `sandbox.env` and `config.toml` file pointing the application to run over the testnet environment. + 6. Create a NymVPN config directory called `nym-vpn` in your `~/.config`, either manually or by a command: ```sh mkdir $HOME/.config/nym-vpn/ ``` -7. Create the network config by saving [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) as `sandbox.env` in the directory `~/.config/nym-vpn/` you just created by running: +7. Create the network testnet config: copy-paste [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) and save as `sandbox.env` in the directory `~/.config/nym-vpn/` you just created. Aternatively do it by runnin a command ```sh curl -o $HOME/.config/nym-vpn/sandbox.env -L https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env ``` -8. Create NymVPN main config file called `config.toml` in the same directory `~/.config/nym-vpn/` with this content: +8. Create NymVPN main config file: copy-paste the line below and save it as `config.toml` in the same directory `~/.config/nym-vpn/`: ```toml # change to your username env_config_file = "/home//.config/nym-vpn/sandbox.env" diff --git a/documentation/dev-portal/src/nymvpn/gui-mac.md b/documentation/dev-portal/src/nymvpn/gui-mac.md index 769e3040da..336a0cede2 100644 --- a/documentation/dev-portal/src/nymvpn/gui-mac.md +++ b/documentation/dev-portal/src/nymvpn/gui-mac.md @@ -58,7 +58,7 @@ NymVPN alpha version runs over Nym testnet (called sandbox), a little extra conf ### Configuration -To test NymVPN alspha two configuration files are needed. An environment config file `sandbox.env` and `config.toml` file pointing the application to run over the testnet environment. +To test NymVPN alpha we must create two configuration files: an environment config file `sandbox.env` and `config.toml` file pointing the application to run over the testnet environment. 5. Create testnet configuration file: Open a text editor, copy-paste [this](https://raw.githubusercontent.com/nymtech/nym/develop/envs/sandbox.env) and save it as `sandbox.env` in `/Applications/nym-vpn.app/Contents/MacOS/`. Alternatively use this command: ```sh From 2eed8e3f6c3cc9e838a29f40fbbb5c4ab527407f Mon Sep 17 00:00:00 2001 From: serinko <97586125+serinko@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:40:38 +0100 Subject: [PATCH 7/7] syntax edit --- documentation/dev-portal/src/SUMMARY.md | 2 +- documentation/dev-portal/src/nymvpn/gui.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/dev-portal/src/SUMMARY.md b/documentation/dev-portal/src/SUMMARY.md index db47668d2f..3a14919b99 100644 --- a/documentation/dev-portal/src/SUMMARY.md +++ b/documentation/dev-portal/src/SUMMARY.md @@ -21,7 +21,7 @@ - [NymVPN alpha](nymvpn/intro.md) - [GUI](nymvpn/gui.md) - [Linux](nymvpn/gui-linux.md) - - [MacOS](nymvpn/gui-mac.md) + - [MacOS](nymvpn/gui-mac.md) - [CLI](nymvpn/cli.md) - [Linux](nymvpn/cli-linux.md) - [MacOS](nymvpn/cli-mac.md) diff --git a/documentation/dev-portal/src/nymvpn/gui.md b/documentation/dev-portal/src/nymvpn/gui.md index 1a027f4f5c..779ddab4dd 100644 --- a/documentation/dev-portal/src/nymvpn/gui.md +++ b/documentation/dev-portal/src/nymvpn/gui.md @@ -8,7 +8,7 @@ Our alpha testing round is done with participants at live workshop events. This This is the alpha version of NymVPN desktop application (GUI). A demo of how the client will look like for majority of day-to-day users. For qualitative testing the [CLI](cli.md) is a necessity but to run the GUI holds the same importance as it provides the user with an experience of the actual app and the developers with a valuable feedback from the users. -Follow the simple [automated script](#automated-script-for-gui-installation) below to install and run NymVPN GUI. If the script didn't work for yur distribution or you prefer to do a manual setup follow the steps in the guide for [Linux](gui-linux.md) or [MacOS](gui-mac.md) . +Follow the simple [automated script](#automated-script-for-gui-installation) below to install and run NymVPN GUI. If the script didn't work for your distribution or you prefer to do a manual setup follow the steps in the guide for [Linux](gui-linux.md) or [MacOS](gui-mac.md) . Visit NymVPN alpha latest [release page]({{nym_vpn_latest_binary_url}}) to check sha sums or download the binaries directly.