Preparing for running the code¶
Notice: There are specialised instructions for docker if you prefer running code this way!
Clone the repository with
git clone https://github.com/hedgedoc/hedgedoc.git hedgedoc-server(cloning is the preferred way, but you can also download and unzip a release)
Enter the directory and run
bin/setup, which will install npm dependencies and create configs. The setup script is written in Bash, you would need bash as a prerequisite.
Setup the config file or set up environment variables.
Running the Code¶
Now that everything is in place, we can start HedgeDoc:
yarn run buildwill build the frontend bundle. It uses webpack to do that.
- Run the server with
Running the Code with Auto-Reload¶
The commands above are fine for production, but you're a developer and surely you want to change things. You would need to restart both commands whenever you change something. Luckily, you can run these commands that will automatically rebuild the frontend or restart the server if necessary.
The commands will stay active in your terminal, so you will need multiple tabs to run both at the same time.
yarn run devif you want webpack to continuously rebuild the frontend code.
To auto-reload the server, the easiest method is to install nodemon and run
nodemon --watch app.js --watch lib --watch locales app.js.
The repository contains two parts: a server (backend) and a client (frontend).
most of the server code is in
/lib and most of the client code is in
hedgedoc-server/ ├── docs/ --- documentation ├── lib/ --- server code ├── test/ --- test suite └── public/ --- client code ├── css/ --- css styles ├── docs/ --- default documents ├── js/ --- js scripts ├── vendor/ --- vendor includes └── views/ --- view templates