Skip to content

GiverofMemory/NatureVault

Repository files navigation

NatureVault - Saving the Worlds Knowledge

As of Sept 11 2023 we moved to Bitbucket and may move to or mirror to Gitlab or another github alternative if needed.

Powered by Vaults

Vaults is our own fork of PmWiki software

Instructions

FOR OFFLINE USE:

  • Download and unzip folder.
  • Inside the server folder double click StartCivetServer.bat
  • Open your browser and go to localhost:8080
    • Sometimes you will need to refresh a page to get it to load, even after editing. This is normal and is a quirk with this version of CivetWeb server, and some browsers are better than others. If you want to use php's server read instructions in the server->server - local only folder.

for more info see https://www.pmwiki.org/wiki/Cookbook/Standalone

FOR NORMAL ONLINE HOSTING:

  • Download this and place these files and folders into the "htdocs" or "public" folder of your server.

    • To do this I like to use SSH if I am not personally hosting it, then when you are in the hosting directory (usually 'public') run (don't forget the period after):

      git clone https://github.com/GiverofMemory/NatureVault.git .

  • Navigate to wiki->local and rename the config.php to offlineconfig.php; and rename onlineconfig.php to config.php.

  • Make sure you check wiki/local/config.php file and modify url's and directory references (like upload directory) to reflect your domain name and your host's folder structure. Without doing this certain things like pictures and skins and cookbooks may not work.

  • If you need to install HTTPS support yourself, using SSH enter the command:tls-setup.sh (or see more options). This certificate is in the ".well-known" folder so don't delete it. If you delete it you may have to wait until the certificate expires to renew, check here: https://crt.sh/. You can only have 5 failed attempts per hour.

  • If you need to remove everything from a folder to start again, use the command:rm -rf *

    • However if you want to use git clone again you may need to FTP into the folder and delete the ".git" folder which doesn't seem to get removed from the above command.
  • Set permissions. You need to FTP (or see below for SSH instructions) using filezilla to set permissions of the wiki -> "wiki.d" folder (not the original wiki.d folder, the one inside the wiki folder) by right clicking the folder and setting permissions, then check all boxes, and also check "recurse to subfolders", and "apply to all files and directories" to allow public write so people can login to the wiki. It should say permission 777.

  • The same as above needs to be done for the wiki -> "Uploads" folder.

  • If you cannot use FTP, here are the SSH comands when you are logged into your server: (note that /home/public might be different for your folder structure)

    • chmod 777 /home/public/wiki/uploads
    • chmod 777 /home/public/wiki/wiki.d
      • aside, the command: chmod 2777 /home/public/wiki/uploads might be temporary?

Notes

  • For personal hosting Abyss Web server works well.
  • after typing out a command always hit the 'enter' key to run it.
  • the period after the 'git clone' statement means that these files and folders are placed into the directory you are in, instead of making a new folder (which won't work).
  • Good websites to get new favicon's made is favicon.io or realfavicongenerator.net
  • For performing daily backups from a webhost like nearlyfreespeech.net and making a discord bot see this page