website

This repository contains everything required to start the Perses demo, the documentation website, etc.

Instructions

On the machine, just pull this repository and run podman-compose up -d

Start the website locally

We recommend you to create a python virtual environment.

python3 -m venv venv
source ./venv/bin/activate # Scripts instead of bin on windows

Then you can install the libs required to run the Perses website:

pip install -r requirements.txt

And finally, you can run the server:

mkdocs serve -a "localhost:8080"

Deploy the website

To build the website, run:

mkdocs build

Then you can run:

podman-compose up -d website

Then website is available at the url http://localhost:1313

Restart the demo

In case you need to restart the demo server after a config change:

1. build the new config:

sh scripts/generate_config.sh

2. restart the demo server:

podman-compose down demo
# wait a bit, otherwise the old instance could still be running and you'd get an "address already in use" error
podman-compose up -d demo