Skip to content

GiverofMemory/Vaults

Repository files navigation

Vaults - Saving Your Knowledge

After Sept 27 2023 will be moved to Bitbucket or Gitlab or another similar github alternative.

Powers NatureVault and the NatureVault website

Vaults is a maintained fork of PmWiki software

Vaults is a specially tuned version of PmWiki that enables you to easily save your knowledge, data, and links and keep it private on your own computer that can be used offline, or host it for the world to see and help you save it (keeping the idea of wiki federation alive). Vaults gives you that wikipedia-like experience to save your data in a very navigable form, all without requiring a database and thus making it much easier to backup. Save your vault on a disk or usb drive and as long as computers are around, it will be able to be accessed. Of course you can also back it up with Git as well.

Instructions

FOR OFFLINE USE:

  • Download and unzip folder.
  • Inside the server folder double click runvaults.bat. A black command window will open, you must leave it open while using Vaults.
  • Open your browser and go to http://localhost/vault/vaults.php

For more information see https://www.pmwiki.org/wiki/Cookbook/Standalone and Collapse documentation

FOR NORMAL ONLINE HOSTING:

Note: I do not intend to keep continuous PHP upgrades. Make sure your webhost supports PHP 7.4

  • 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/Vaults.git .

  • Navigate to vault->local (using FTP or SSH) and rename the config.php to offlineconfig.php; and rename onlineconfig.php to config.php.
  • Make sure you check vault/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 will not work.
  • If you need to install HTTPS (TLS) support yourself, using SSH enter the command:tls-setup.sh (or see more options or install tls-setup.sh). This certificate is in the ".well-known" folder so don't delete it. If you delete it or uninstall your site or remove your site from hosting you may have to wait until the certificate expires to renew, check here: https://crt.sh/. Depending on your host you may be able to run tls-setup.sh -r. 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) to set permissions of the vault -> "vault.d" folder (not the original vault.d folder, the one inside the vault 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 vault. It should say permission 777.
  • The same as above needs to be done for the vault -> "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/vault/uploads
    • chmod 777 /home/public/vault/vault.d
      • aside, the command: chmod 2777 /home/public/vault/uploads might be temporary?

TO ADD ANOTHER VAULT

For more information see https://www.pmwiki.org/wiki/PmWiki/WikiFarms

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

About

Helping you to preserve your knowledge for the ages.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published