Install Parsec CLI (Linux)

In order to deploy and maintain Parsec Server, you would need to perform some operations with Parsec CLI for Linux. These operations can be performed from another machine.

Parsec CLI is a standalone binary that can be downloaded from GitHub releases page.

  1. Download Parsec CLI.

  2. Make the file executable

    • Right-click on file, then Properties ‣ Allow executing file as program

    • Or use the chmod command:

      chmod +x parsec-cli_3.9.4-a.0+dev_linux-x86_64-musl
      
  3. Verify the installation by running the following command:

    ./parsec-cli_3.9.4-a.0+dev_linux-x86_64-musl --version
    

    The Parsec CLI version should be displayed as parsec-cli 3.9.4-a.0+dev

  4. For convenience, put the executable in ~/.local/bin

    cp parsec-cli_3.9.4-a.0+dev_linux-x86_64-musl ~/.local/bin
    

    and make a symbolic link

    cd  ~/.local/bin
    ln -s parsec-cli_3.9.4-a.0+dev_linux-x86_64-musl parsec-cli
    

    You will be able to execute parsec-cli from anywhere.

Tip

To update, follow the previous steps with the new version.

Enable auto-completion

Added in version 3.10.0: To have your shell auto-complete the parsec-cli command arguments, you will need to have the following line in your shell RC file:

eval "$(parsec-cli auto-complete $SHELL)"

Note

The above code-snippet is for bash, adapt it to your shell.

Install man pages

Added in version 3.10.0: You can install the Parsec CLI man pages by doing the following:

  1. Create the local man pages folder:

    mkdir -p ~/.local/share/man/man1
    

    Tip

    To make the pages available system-wide, replace the folder path with /usr/local/share/man/man1 on the commands above and below.

  2. Generate the man pages:

    parsec-cli man-page --mode separate ~/.local/share/man/man1
    
  3. Update the man pages database:

    mandb
    
  4. Verify:

    man parsec-cli
    

    Important

    If man cannot find the page, ensure that the path where you put the pages is in the variable $MANPATH. You can also verify if mandb explored the folder.