Greenmine/install

From Woozle Writes Code
< Greenmine
Revision as of 19:57, 23 February 2021 by Woozle (talk | contribs)
Jump to navigation Jump to search
  • Install Ferreteria
    • This creates some folders which the following instructions assume already exist.
  • Clone the Greenmine Git repository into a folder of your choice, which we'll call <greenmine base>.
  • Copy the <greenmine base>/config folder to a location outside of [greenmine base].
    • We'll call this new location <local config>.
    • My standard location for this is /home/<user>/site/config/greenmine
  • Make a copy of the <local config>/example folder and name it <local config>/local.

documentation in progress

Steps

After installing Ferreteria, run these commands in a terminal on your web server:

cd <$HOME>
su <$USER>
cd site/git
git clone git@gitlab.com:woozalia/greenmine.git
cd ../config

For standard install:

cp -R ../git/greenmine/config greenmine
cp -R greenmine/example greenmine/local

This just copies the config folders from the git repository into the site configuration.

For developers:

mkdir greenmine
ln -rs ../git/greenmine/config/example greenmine/example
ln -rs ../git/greenmine/config/portable greenmine/portable

This makes links from the site configuration folders back to the git repository, so any alterations to portable files will be included in git commits.

Then edit the files in greenmine/local as needed. You will definitely need to edit creds.php in order to get things working.

documentation in progress

Note: might want to link instead of copying files that don't need to be edited, so the defaults get updated. Investigate later.