mirror of
https://github.com/overleaf/overleaf.git
synced 2024-12-26 09:32:45 +00:00
0a470fb54f
* Avoid stray backslash in ggrep pattern * Add new services to README * Avoid building in bin/up * Add init script * Update README.md * Use cURL to wait for MongoDB * Add a note about COMPOSE_PARALLEL_LIMIT * Use the new callout syntax GitOrigin-RevId: 9aaec37e893a2da807fed2dc4b00fa52a433c390
95 lines
2.8 KiB
Markdown
95 lines
2.8 KiB
Markdown
# Overleaf Community Edition, development environment
|
|
|
|
## Building and running
|
|
|
|
In this `develop` directory, build the services:
|
|
|
|
```shell
|
|
bin/build
|
|
```
|
|
|
|
> [!NOTE]
|
|
> If Docker is running out of RAM while building the services in parallel, create a `.env` file in this directory containing `COMPOSE_PARALLEL_LIMIT=1`.
|
|
|
|
Next, initialize the database:
|
|
|
|
```shell
|
|
bin/init
|
|
```
|
|
|
|
Then start the services:
|
|
|
|
```shell
|
|
bin/up
|
|
```
|
|
|
|
Once the services are running, open <http://localhost/launchpad> to create the first admin account.
|
|
|
|
## TeX Live
|
|
|
|
Compiling a PDF requires building a TeX Live image to handle the compilation inside Docker:
|
|
|
|
```shell
|
|
docker build texlive -t texlive-full
|
|
```
|
|
|
|
> [!NOTE]
|
|
> To compile on a macOS host, you may need to override the path to the Docker socket by creating a `.env` file in this directory, containing
|
|
> `DOCKER_SOCKET_PATH=/var/run/docker.sock.raw`
|
|
|
|
## Development
|
|
|
|
To avoid running `bin/build && bin/up` after every code change, you can run Overleaf
|
|
Community Edition in _development mode_, where services will automatically update on code changes.
|
|
|
|
To do this, use the included `bin/dev` script:
|
|
|
|
```shell
|
|
bin/dev
|
|
```
|
|
|
|
This will start all services using `nodemon`, which will automatically monitor the code and restart the services as necessary.
|
|
|
|
To improve performance, you can start only a subset of the services in development mode by providing a space-separated list to the `bin/dev` script:
|
|
|
|
```shell
|
|
bin/dev [service1] [service2] ... [serviceN]
|
|
```
|
|
|
|
> [!NOTE]
|
|
> Starting the `web` service in _development mode_ will only update the `web`
|
|
> service when backend code changes. In order to automatically update frontend
|
|
> code as well, make sure to start the `webpack` service in _development mode_
|
|
> as well.
|
|
|
|
If no services are named, all services will start in development mode.
|
|
|
|
## Debugging
|
|
|
|
When run in _development mode_ most services expose a debugging port to which
|
|
you can attach a debugger such as
|
|
[the inspector in Chrome's Dev Tools](chrome://inspect/) or one integrated into
|
|
an IDE. The following table shows the port exposed on the **host machine** for
|
|
each service:
|
|
|
|
| Service | Port |
|
|
| ------------------ | ---- |
|
|
| `web` | 9229 |
|
|
| `clsi` | 9230 |
|
|
| `chat` | 9231 |
|
|
| `contacts` | 9232 |
|
|
| `docstore` | 9233 |
|
|
| `document-updater` | 9234 |
|
|
| `filestore` | 9235 |
|
|
| `notifications` | 9236 |
|
|
| `real-time` | 9237 |
|
|
| `history-v1` | 9239 |
|
|
| `project-history` | 9240 |
|
|
|
|
To attach to a service using Chrome's _remote debugging_, go to
|
|
<chrome://inspect/> and make sure _Discover network targets_ is checked. Next
|
|
click _Configure..._ and add an entry `localhost:[service port]` for each of the
|
|
services you want to attach a debugger to.
|
|
|
|
After adding an entry, the service will show up as a _Remote Target_ that you
|
|
can inspect and debug.
|