Skip to content

Latest commit

 

History

History
63 lines (45 loc) · 1.49 KB

INSTALL-LINUX.md

File metadata and controls

63 lines (45 loc) · 1.49 KB

Installation on Linux

Pre-requisites:

  • python >= 3.3
  • python-dev (required to build some dependencies)
  • poetry
  • git
  • nodejs
  • npm

To install those on Ubuntu:

sudo apt-get install python3 python3-dev python3-poetry git nodejs npm

Checkout picard-website and configure it:

git clone https://github.com/musicbrainz/picard-website/
cd picard-website
cp website/config.py.example website/config.py

Edit website/config.py so that PLUGINS_BUILD_DIR points to the directory where the plugin builds are to be generated:

vim website/config.py

Install Python dependencies:

poetry install

Install node dependencies (requires Node.js):

npm install

Node dependencies (including less and cleancss, which are required to compile/minify CSS) are installed to ./node_modules, and binaries are symlinked into ./node_modules/.bin. You may want to add the latter into your $PATH.

To retrieve picard-plugins repository and generate plugins.json and zipped plugin archives needed by Picard Website and plugins webservice, run:

poetry run python plugins-generate.py

Compile CSS and translations:

npm run build

To run the development server, do:

poetry run python run.py

By default, it listens on 127.0.0.1 port 6060. This can be changed in config.py by modifying SERVER_HOSTNAME and SERVER_PORT.