Direkt zum Hauptinhalt

Installation

Main Server

You can either build the application from source or use a prebuilt binary (only linux x64).

Build from Source

  1. You will need to have rustc, cargo and npm installed & in your path
  2. Clone the repository: git clone https://github.com/Verfassungsblog/Verfassungsbooks .
  3. Install handlebars & the typescript compiler: npm install -g handlebars typescript
  4. cd into typescript & run: cd typescript && npm install
  5. Build with cargo: cd ../ && cargo build --release
  6. Run with cargo run or with target/release/Verfassungsbooks

Use a prebuilt binary

  1. Download the latest release from GitHub
  2. extract the archive: tar -xf verfassungsbooks-bundled.tar.gz
  3. Run with ./Verfassungsbooks (or create a systemd service)

Adjust Configuration

<TODO>

Example Systemd Service File

To register the server as a systemd service with autostart and running in the background you may use this service file (save as /etc/systemd/system/verfassungsbooks-server.service)

[Unit]
Description=Verfassungsbooks Server
After=network.target

[Service]
WorkingDirectory=/home/verfassungsbooks/verfassungsbooks-server
ExecStart=/home/verfassungsbooks/verfassungsbooks-server/Verfassungsbooks
Restart=always
User=verfassungsbooks

[Install]
WantedBy=multi-user.target

You will need to create a user verfassungsbooks (or change the username in the service file) and change the WorkingDirectory to the directory your installation files lye in. Then adjust the ExecStart so it points to the executable (Verfassungsbooks or target/release/Verfassungsbooks). 

Now you can start the server with systemctl start verfassungsbooks-server. Logs are redirected to your journal (use journalctl -xe).

Rendering Server

nach oben