mirror of
https://github.com/overleaf/overleaf.git
synced 2024-12-27 12:21:03 +00:00
41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
writelatex-git-bridge
|
|
=====================
|
|
|
|
Required
|
|
--------
|
|
* `maven` (for building)
|
|
* `jdk-7` (for compiling and running)
|
|
|
|
Installation
|
|
------------
|
|
### Ubuntu ###
|
|
Run `./install` to get dependencies, build, test, package, and make it a service.
|
|
|
|
Use `sudo service wlgb start` and `sudo service wlgb stop` to start and stop the server.
|
|
|
|
The configuration file will be at `/etc/wlgb/config.json`.
|
|
|
|
Run `./reinstall` to test, package and install the current version if `./install` has already been run.
|
|
|
|
Run `./uninstall` to undo what `./install` did.
|
|
### Manually ###
|
|
Run `mvn package` to build, test, and package it into a jar at `target/writelatex-git-bridge-1.0-SNAPSHOT-jar-with-dependencies.jar`.
|
|
|
|
Use `java -jar <path_to_jar> <path_to_config_file>` to run the server.
|
|
|
|
Runtime Configuration
|
|
---------------------
|
|
|
|
The configuration file is in `.json` format. There is an example at `bin/config.json`.
|
|
|
|
{
|
|
"port" (int): the port number,
|
|
"rootGitDirectory" (string): the directory in which to store git repos and the db/atts,
|
|
"apiBaseUrl" (string): base url for the snapshot api,
|
|
"username" (string, optional): username for http basic auth,
|
|
"password" (string, optional): password for http basic auth,
|
|
"postbackBaseUrl" (string): the postback url,
|
|
"serviceName" (string): current name of writeLaTeX in case it ever changes
|
|
}
|
|
|
|
You have to restart the server for configuration changes to take effect.
|