Before You Start
Choose Your Patform
Below you will see instructions on installing Serge on your system with the necessary dependencies. If you prefer to keep things isolated, you can also install Serge as a Docker container.
Select Preferred Version
Installing Serge on Windows Unix Mac OS
Serge can run on any OS with Perl 5.10 or higher. UnixMac OS systems have Perl already installed. On Windows, we recommend installing Strawberry Perl.
You can check your Perl version by running this command:
Step 1. Create a Directory for Serge
Serge can work in any directory. So create a new directory for Serge application files. For example:
Step 2. Download the Stable ReleaseLatest Code Snapshot
cd ~/serge wget https://github.com/evernote/serge/archive/master<version>.zip -O serge-master<version>.zip unzip serge-master<version>.zip unlink serge-master<version>.zip cd serge-master<version>
Download https://github.com/evernote/serge/archive/master<version>.zip and unpack it to
Step 3. Install Dependencies
Some Perl modules that you're about to install in step 3.2 require compiling binaries from sources. Run your package manager to install build essentials and library headers. For example, on Ubuntu/Debian this will be:
sudo apt-get -qq update sudo apt-get -qq -y install build-essential libssl-dev libexpat-dev
Installing/upgrading Perl dependencies is done with the help of
cpanm package manager, which needs to be installed with the following command:
sudo cpan App::cpanminusOnce you have it installed, run the following commands:
cd ~/serge/C:\Serge\serge-master<version> sudo cpanm --installdeps .
Step 4. Make Serge Available from Any Directory
C:\Serge\serge-master<version>\bin directory to your
PATH environment variable in Windows settings (make sure to remove the path to the previous version of Serge if it was there). After that you will need to close and open a new shell window so that it would pick up the changes.
Create a symlink to
sudo ln -s ~/serge/serge-master<version>/bin/serge /usr/local/bin/serge
Step 5. Verify the Installation
Run this command to see command-line help from Serge:
Step 6. Generate HTML Help
If you're installing Serge on your development machine, you can take advantage of using HTML help that will open in your browser. Run the following command to generate the HTML version of the help for Serge commands:
To test the result, run:
This will open a help page in the browser.