github/hedgedoc
1
0
Fork 0
mirror of https://github.com/hedgedoc/hedgedoc.git synced 2025-02-23 16:21:40 +00:00
Code Issues Projects Releases Packages Wiki Activity
hedgedoc/docs/content/dev/getting-started.md
Chasethechicken a0cfc2bc06 Apply suggestions from code review 
Use real backend by default.
Start server with NODE_ENV set to development mode.

Co-authored-by: David Mehren <git@herrmehren.de>
Signed-off-by: Falk Rehse <neuringe1234@gmail.com>
2021-12-20 13:16:01 +01:00

2 KiB
Raw Blame History

Getting started

Preparing for running the backend code

ToDo: Document how to setup development environment using docker.

  1. Clone the repository with git clone https://github.com/hedgedoc/hedgedoc.git (cloning is the preferred way, but you can also download and unzip a release)

  2. Enter the directory and run yarn install.

  3. Run cp .env.example .env to use the example configuration.

    Alternatively, set up a .env or set up environment variables yourself.

  4. Run openssl rand -hex 16 | sed -E 's/(.*)/HD_SESSION_SECRET=\1/' >> .env to generate a session secret if you have not set one manually before.

Preparing for running the frontend code

ToDo: Document how to setup development environment using docker.

  1. Clone the repository with git clone https://github.com/hedgedoc/react-client.git (cloning is the preferred way, but you can also download and unzip a release)

  2. Enter the directory and run yarn install.

Running Hedgedoc with auto-reload

We will run Hedgedoc in development mode, which means the backend and frontend will automatically rebuild or restart when you make changes.

The commands will stay active in your terminal, so you will need multiple tabs to run both at the same time.

  1. Enter the react-frontend directory and use yarn start:for-real-backend if you want webpack to continuously rebuild the frontend code. The frontend will expect a running backend at port 3000.

    Note: You can run yarn start to start a frontend with an integrated, mocked API. This may support more features than the real backend.

  2. To start the server in auto-reload mode, enter the hedgedoc directory and run env NODE_ENV=development yarn start:dev.

Testing

  • The backend will be available at http://localhost:3000.
  • The frontend will be available at http://localhost:3001.

Note: The backend proxies requests to the frontend, so you can also point your browser at the backend.