Greenmine/install

From Woozle Writes Code
< Greenmine
Revision as of 23: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.

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:

ln -rs ../git/greenmine/dropins/WorkFerret WorkFerret
  • 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

TODO: document creation of database and tables