Installation Guide for Matrix 6


(Lauren) #1

Hi All,

I have tried in vain to install Squiz Matrix 6 using the core code matrix-6.18.1.tgz (15.7 MB) . Has anyone successfully installed it?

Thanks,
Lauren


(John gill) #2

The v5 installation guide (https://matrix.squiz.net/resources/installation-guides/manual-installation-guide) is still broadly correct, the main changes are to the dependencies.

I use https://github.com/cjc/composed-matrix-6 as a reference - even if you don’t want to use docker, this is a decent inventory of all the required dependencies (Postgres, Redis, PHP&Extensions, Nginx and config) and installation steps (https://github.com/cjc/composed-matrix-6/blob/master/php/install.sh).


(Lauren) #3

Brilliant!! Thanks John,

I haven’t used Docker, however, today might be the day to learn.

Thanks again for your quick reply.

Lauren


(Mark Graham) #4

@JohnGill have you tried installing the newer versions of Matrix 6 (.19 or .20)?

I’m getting errors related to the fact that the “frontend” folder doesn’t exist in these downloads.


(John gill) #5

Haven’t tested past 6.18.1, but as of V6 you need to run npm build in the source to build the new react-powered admin parts.

It’s not part of the docker-compose file, but it’s in the tldr.sh script (although still pointing at 6.15)

wget https://matrix.squiz.net/__data/assets/file/0030/37965/matrix-6.15.0.tgz
mkdir source
tar -xzf matrix-6.15.0.tgz -C source/

cd source/
npm install
npm run build
cd ..

Amusing consideration - it seems to take more RAM to build the JavaScript than it does to run Matrix. In my experience the npm build fails on a VM with <2GB.


(Keith Brown) #6

Hi all,

Quick one - I’ve been away from Squiz for a while and had a go at installing the latest (6.25) as a catch-up project. There appears to be the “frontend” folder missing from the archive tho and so npm falls over…

Squiz Guys - can you update?

K


(David Schoen) #7

The npm steps shouldn’t be required, the files are compiled out of frontend directory before the artifact is built.


(Keith Brown) #8

…thanks! this weekend’s messing about and I got things installed!