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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
# Mullvad VPN desktop and mobile app
The back- and frontend for the Mullvad VPN app.
## Status
There is a beta release for macOS available on
[our website](https://mullvad.net/en/guides/beta-app/) and on
[github](https://github.com/mullvad/mullvadvpn-app/releases/).
Support for Linux, Windows, Android and iOS is in the making.
## Checking out the code
This repository contains a submodule, so clone it recursively:
```
git clone --recursive https://github.com/mullvad/mullvadvpn-app.git
```
## Install toolchains and dependencies
1. Get the latest stable Rust toolchain. This is easy with rustup, follow the instructions on
[rustup.rs](https://rustup.rs/).
1. Get Node.js (version 8 or 9) and the latest version of yarn. On macOS these can be installed via
homebrew:
```bash
brew install node yarn
```
## Building and running the backend (mullvad-daemon)
1. Build the backend without optimizations (debug mode) with:
```
cargo build
```
1. Run the backend daemon debug binary with verbose logging to the terminal with:
```
sudo ./target/debug/mullvad-daemon -vv
```
It must run as root since it it modifies the firewall and sets up virtual network interfaces
etc.
## Building and running the frontend (electron app)
1. Install all the JavaScript dependencies by running:
```bash
yarn install
```
1. Start the frontend in development mode by running:
```bash
yarn run develop
```
If you change any javascript file while the development mode is running it will automatically
transpile and reload the file so that the changes are visible almost immediately.
The app will attempt to start the backend automatically. The exact binary being run can be
customized with the `MULLVAD_BACKEND` environment variable.
If the `/tmp/.mullvad_rpc_address` file exists the app will not start the backend, so if you want
to run a specific version of the backend you can just start it yourself and the app will pick up on
it and behave accordingly.
## Packaging the app
1. Follow the [Install toolchains and dependencies](#install-toolchains-and-dependencies) steps
1. Build the backend in optimized release mode with:
```
./build.sh
```
1. Install build dependencies if you are on Linux
```bash
sudo apt install icnsutils graphicsmagick
```
1. Install all JavaScript dependencies (unless you already have) and package the application with:
```bash
yarn install
yarn run pack
```
This will create installation packages for windows, linux and MacOS. Note that you have to have
run `yarn install` at least once before this step to download the javascript dependencies.
If you only want to build for a specific OS you run
```bash
yarn run pack:OS
```
as in `yarn run pack:linux`.
The artifact (.dmg, .deb, .msi) version is the `version` property of `package.json`.
## Command line tools for frontend development
- `$ yarn run develop` - develop app with live-reload enabled
- `$ yarn run flow` - type-check the code
- `$ yarn run lint` - lint code
- `$ yarn run pack` - prepare app for distribution for macOS, Windows, Linux. Use `pack:mac`,
`pack:win` or `pack:linux` to generate package for single target.
- `$ yarn run test` - run tests
## Repository structure
- **app/**
- **redux/** - state management
- **components/** - components
- **containers/** - containers that provide a glueing layer between components and redux
actions/backend.
- **lib/** - shared classes and utilities
- **assets/** - graphical assets and stylesheets
- **config.json** - links to external components
- **app.js** - entry file for renderer process
- **main.js** - entry file for background process
- **routes.js** - routes configurator
- **transitions.js** - transition rules between views
- **types.js** - common Flow types used across the app
- **build.sh** - Builds the backend in release mode. Will be extended to take care of more parts
of the release compiling and packaging.
- **Cargo.toml** - Main Rust workspace definition. See this file for which folders here are backend
Rust crates.
- **client-binaries/** - Git submodule containing binaries shipped with the client. Most notably
the OpenVPN binaries.
- **format.sh** - Script that runs rustfmt to format the Rust code
- **init.js** - entry file for electron, points to compiled **main.js**
- **mullvad-daemon/** - Main Rust crate building the backend daemon binary
- **scripts/** - support scripts for development
- **test/** - frontend tests
- **uninstall.sh** - Temporary script to help uninstall Mullvad VPN, all settings files, caches and
logs.
# License
Copyright (C) 2017 Amagicom AB
This program is free software: you can redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation, either version 3 of
the License, or (at your option) any later version.
|
