ZIP installation
1. Download and unzip
Simply download a new Upsource build from here and unzip the downloaded archive to a server directory of your preference. Later in this documentation it will be referred to as the <upsource_home> directory.
What's inside Upsource
The Upsource distribution bundles a set of different components including:
Upsource services including the frontend, VCS analysis, and monitoring
Apache Cassandra, the default bundled database
Hub, a JetBrains service for authentication, user and group management
2. Make some system adjustments
Disable conflicting software (Windows)
If you run Upsource on Windows, please disable all anti-viruses, Windows Defender, and Windows Search service for Upsource root directory, as they may conflict with Upsource processes.
Adjust resource limits (Linux)
If you run Upsource on Linux, insufficient resource limits may result in a number of errors. To prevent that, we recommend to set:
maximum open files to 100000
memory locking and address space limit to unlimited
number of processes to 32768
You can do it by adding the following lines to the /etc/security/limits.conf file:
Configuration options
You can also:
Install and configure a standalone Hub which is required for YouTrack integration
As soon as you have made all configuration changes that are relevant in your environment, you can proceed to start Upsource.
3. Start Upsource
For Windows, run the following command:
For Linux or macOS, run the following command:
To start Upsource on OS X or Linux platforms, execute the command as a non-root user.
4. Walk through the Wizard steps
Upsource Configuration Wizard will open in your browser. Follow the steps described in Things to configure after the first start.