github.com/psiphon-labs/psiphon-tunnel-core@v2.0.28+incompatible/ConsoleClient/README.md (about)

     1  ## Psiphon Console Client README
     2  
     3  ### Building with Docker
     4  
     5  Note that you may need to use `sudo docker` below, depending on your OS.
     6  
     7  ##### Create the build image:
     8  
     9  1. While in the `ConsoleClient` directory, run the command: `docker build --no-cache=true -t psiclient .`
    10  
    11  2. Once completed, verify that you see an image named `psiclient` when running: `docker images`
    12  
    13  ##### Run the build:
    14  
    15  *Ensure that the command below is run from within the `ConsoleClient` directory*
    16  
    17  ```bash
    18  cd .. && \
    19    docker run \
    20    --rm \
    21    -v $PWD:/go/src/github.com/Psiphon-Labs/psiphon-tunnel-core \
    22    psiclient \
    23    /bin/bash -c './make.bash all' \
    24  ; cd -
    25  ```
    26  
    27  This command can also be modified by:
    28   - replacing `all` with `windows`, `linux`, or `osx` as the first parameter to `make.bash` (as in `...&& ./make.bash windows`) to only build binaries for the operating system of choice
    29     - if `windows` or `linux` is specified as the first parameter, the second parameter can be passed as either `32` or `64` (as in `...&& ./make.bash windows 32`)to limit the builds to just one or the other (no second parameter means both will build)
    30  
    31  When that command completes, the compiled binaries will be located in the `bin` directory (`./bin`, and everything under it will likely be owned by root, so be sure to `chown` to an appropriate user) under the current directory. The structure will be:
    32  
    33  ```
    34  bin
    35  ├── darwin
    36  │   └── psiphon-tunnel-core-x86_64
    37  ├── linux
    38  │   └── psiphon-tunnel-core-i686
    39  │   └── psiphon-tunnel-core-x86_64
    40  └── windows
    41      └── psiphon-tunnel-core-i686.exe
    42      └── psiphon-tunnel-core-x86_64.exe
    43  
    44  ```