{"id":13852325,"url":"https://github.com/fisharebest/webtrees","last_synced_at":"2025-07-01T12:07:46.966Z","repository":{"id":37502397,"uuid":"11836349","full_name":"fisharebest/webtrees","owner":"fisharebest","description":"Online genealogy","archived":false,"fork":false,"pushed_at":"2025-06-23T19:31:25.000Z","size":882770,"stargazers_count":618,"open_issues_count":429,"forks_count":314,"subscribers_count":23,"default_branch":"main","last_synced_at":"2025-06-23T20:29:33.611Z","etag":null,"topics":["family-history","family-tree","gedcom","genealogy","webtrees"],"latest_commit_sha":null,"homepage":"https://webtrees.net","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fisharebest.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-08-02T06:13:41.000Z","updated_at":"2025-06-23T13:11:56.000Z","dependencies_parsed_at":"2023-12-01T15:30:30.910Z","dependency_job_id":"fd6f13f1-9128-4c7d-98e1-5d2a66b1fcb8","html_url":"https://github.com/fisharebest/webtrees","commit_stats":{"total_commits":19502,"total_committers":263,"mean_commits":74.15209125475285,"dds":0.5751205004614911,"last_synced_commit":"e5766395c1a71e715ebaadcf2d63d036d60fb649"},"previous_names":[],"tags_count":122,"template":false,"template_full_name":null,"purl":"pkg:github/fisharebest/webtrees","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisharebest%2Fwebtrees","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisharebest%2Fwebtrees/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisharebest%2Fwebtrees/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisharebest%2Fwebtrees/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fisharebest","download_url":"https://codeload.github.com/fisharebest/webtrees/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisharebest%2Fwebtrees/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262959569,"owners_count":23391059,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["family-history","family-tree","gedcom","genealogy","webtrees"],"created_at":"2024-08-04T22:01:15.181Z","updated_at":"2025-07-01T12:07:46.942Z","avatar_url":"https://github.com/fisharebest.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"![Latest version](https://img.shields.io/github/v/release/fisharebest/webtrees?sort=semver)\n![Licence](https://img.shields.io/github/license/fisharebest/webtrees)\n[![Unit tests](https://github.com/fisharebest/webtrees/actions/workflows/phpunit.yaml/badge.svg)](https://github.com/fisharebest/webtrees/actions/workflows/phpunit.yaml)\n[![codecov](https://codecov.io/gh/fisharebest/webtrees/branch/main/graph/badge.svg?token=zREQBP4GBs)](https://codecov.io/gh/fisharebest/webtrees)\n[![Translation status](https://translate.webtrees.net/widgets/webtrees/-/webtrees-22/svg-badge.svg)](https://weblate.iet.open.ac.uk/projects/webtrees/webtrees-22)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/fisharebest/webtrees/badges/quality-score.png?b=main)](https://scrutinizer-ci.com/g/fisharebest/webtrees/?branch=main)\n[![Code Climate](https://codeclimate.com/github/fisharebest/webtrees/badges/gpa.svg)](https://codeclimate.com/github/fisharebest/webtrees)\n[![StyleCI](https://github.styleci.io/repos/11836349/shield?branch=main)](https://github.styleci.io/repos/11836349?branch=main)\n# webtrees - online collaborative genealogy\n\n## Contents\n\n* [License](#license)\n* [Coding styles and standards](#coding-styles-and-standards)\n* [Introduction](#introduction)\n* [System requirements](#system-requirements)\n* [Internet browser compatibility](#browser-compatibility)\n* [Installation](#installation)\n* [Upgrading](#upgrading)\n* [Building and developing](#building-and-developing)\n* [Gedcom (family tree) files](#gedcom-family-tree-files)\n* [Security](#security)\n* [Backup](#backup)\n* [Restore from Backup](#restore-from-backup)\n\n## License\n\n* **webtrees: online genealogy**\n* Copyright 2022 webtrees development team\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program. If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n## Coding styles and standards\n\nwebtrees follows the [PHP Standards Recommendations](https://www.php-fig.org/psr).\n\n* [PSR-1](https://www.php-fig.org/psr/psr-1) - Basic Coding Standard\n* [PSR-2](https://www.php-fig.org/psr/psr-2) - Coding Style Guide\n* [PSR-4](https://www.php-fig.org/psr/psr-4) - Autoloading Standard\n* [PSR-6](https://www.php-fig.org/psr/psr-6) - Cache\n* [PSR-7](https://www.php-fig.org/psr/psr-7) - HTTP Message Interface\n* [PSR-11](https://www.php-fig.org/psr/psr-11) - Container Interface\n* [PSR-12](https://www.php-fig.org/psr/psr-12) - Extended Coding Style Guide\n* [PSR-15](https://www.php-fig.org/psr/psr-15) - HTTP Handlers\n* [PSR-17](https://www.php-fig.org/psr/psr-17) - HTTP Factories\n\nWe do not currently use [PSR-3 (logging)](https://www.php-fig.org/psr/psr-3) - but we plan to do so in the future.\n\nFor JavaScript, we use [semistandard](https://github.com/standard/semistandard).\n\n## Introduction\n\n**webtrees** is the web's leading online collaborative genealogy application.\n\n* It works from standard GEDCOM files, and is therefore compatible with every\nmajor desktop application.\n* It aims to to be efficient and effective by using the right combination of\nthird-party tools, design techniques and open standards.\n\n**webtrees** allows you to view and edit your genealogy on your website. It has\nfull editing capabilities, full privacy functions, and supports imedia such as\nphotos and document images. As an online program, it fosters extended family\nparticipation and good ancestral recording habits, as it simplifies the process\nof collaborating with others working on your family lines. Your latest information\nis always on your web site and available for others to see, defined by viewing\nrules you set. For more information and to see working demos, visit\n[webtrees.net](https://webtrees.net/).\n\n**webtrees** is Open Source software that has been produced by people from many\ncountries freely donating their time and talents to the project. All service,\nsupport, and future development is dependent on the time developers are willing\nto donate to the project, often at the expense of work, recreation, and family.\nBeyond the few donations received from users, developers receive no compensation\nfor the time they spend working on the project. There is also no outside source\nof revenue to support the project. Please consider these circumstances when\nmaking support requests and consider volunteering your own time and skills to make\nthe project even stronger and better.\n\n## System requirements\n\nTo install **webtrees**, you need:\n\n* A webserver. Apache, NGINX and IIS are the most common types. To use “Pretty URLs”, you will need to configure URL rewriting\"\n* A database. MySQL is recommended, although PostgreSQL, SQL-Server and SQLite can be used. Some features rely on MySQL for collation.  Other database might not sort names according to local rules.  **webtrees** uses a prefix for its table names, so you can install several instances of webtrees in the same database.\n* Approximately 100MB of disk space for the application files, plus whatever is\n  needed for your media files, GEDCOM files and database.\n* PHP 7.1 - 7.4. Servers with PHP 5.3 - 7.0 can use **webtrees** 1.7.\n   * PHP should be configured to allow sufficient server resources (memory and\n     execution time) for the size of your system. Typical requirements are:\n      * Small systems (500 individuals): 16–32 MB, 10–20 seconds\n      * Medium systems (5,000 individuals): 32–64 MB, 20–40 seconds\n      * Large systems (50,000 individuals): 64–128 MB, 40–80 seconds\n\n## Browser compatibility\n  \n  **webtrees** is tested on recent versions of popular browsers such as Edge, Firefox,\n  Chrome, and Safari.  Support for other browsers and older versions is on a case-by-case basis.\n\n## Installation\n\n1. Download the .ZIP file for latest stable version from [github.com](https://github.com/fisharebest/webtrees/releases/latest).\n2. Unzip the files and then upload them to an empty folder on your web server.\n3. Open your web browser and type the URL for your **webtrees** site (for example,\n   ``https://www.yourserver.com/webtrees`` into the address bar.\n4. The **webtrees** setup wizard will start automatically.\n\nYour first task will be to create a family tree.\n\nIf you have a GEDCOM file, you can import it into the tree. If not, just start\nentering your family tree. \n\nThere are lots of configuration options. You'll probably want to review the\nprivacy settings first. Don't worry too much about all the other options - the\ndefaults are good for most people. If you get stuck, you can get friendly help\nand advice from the [help](https://www.webtrees.net/index.php/forum) forum.\n\n## Upgrading\n\nUpgrading **webtrees** is quick and easy. It is strongly recommended that you\nupgrade your installation whenever a new version is made available. Even minor\n**webtrees** version updates usually contain a significant number of bug fixes\nas well as interface improvements and program enhancements.\n\n* **Automatic upgrade**\n\n  **webtrees** has an automatic upgrade facility. An administrator upon logging in\nwill receive notification when a new version is available and an option to start\nthe automatic upgrade. If for some reason the automatic upgrade should fail\nthen a manual upgrade should be performed.\n\n* **Manual upgrade**\n\n  1. Now would be a good time to make a [backup](#backup).\n  2. Download the latest version of **webtrees** available from\n   [webtrees.net](https://webtrees.net/)\n  3. While you are in the middle of uploading the new files,\n   a visitor to your site would encounter a mixture of new and old files. This\n   could cause unpredictable behavior or errors. To prevent this, create the\n   file **data/offline.txt**. While this file exists, visitors will see a\n   “site unavailable - come back later” message.\n  4. Unzip the .ZIP file, and upload the files to your web server, overwriting the existing files.\n  5. Delete the file **data/offline.txt**.\n\n### Note for Macintosh users\n\nStep 4 assumes you are using a copy tool that **merges** directories rather than\nreplaces them. (**Merge** is standard behavior on Windows and Linux.) If you use\nthe Macintosh Finder or other similar tool to perform step 3, it will **replace**\nyour configuration, media and other directories with the empty/default ones from\nthe installation. This would be very bad (but you did take a backup in step 1,\ndidn't you!). Further details and recommendations for suitable tools can be found\nby searching [google.com](https://google.com).\n\n## Building and developing\n\nIf you want to build webtrees from source, or modify the code, you'll need to install\na couple of tools first.\n\nYou will need [composer](https://getcomposer.org/) to install the PHP dependencies.\nThen run this command::\n\n* php composer.phar install\n\nYou will need [npm](https://www.npmjs.com/get-npm) to install the Javascript dependencies.\nThen run the commands:\n\n* npm install\n* npm run production\n\nYou will need to re-run the second of these any time you modify the file `webtrees.js`.\n\n## Gedcom (family tree) files\n\nWhen you import a family tree (GEDCOM) file in **webtrees** the\ndata from the file is transferred to the database tables. The file itself \nremains in the **webtrees/data** folder and is no longer used or required\nby **webtrees**. Any subsequent editing of the **webtrees** data\nwill not change this file\n\nWhen or if you change your genealogy data outside of **webtrees**, it is not\nnecessary to delete your GEDCOM file or database from **webtrees** and start\nover. Follow these steps to update a GEDCOM that has already been imported:\n\n* Go to ``Control panel`` -\u003e ``Manage family trees`` On the line relating to this particular family tree (GEDCOM)\n  file (or a new one) select IMPORT.\n* Take careful note of the media items option (_“If you have created media objects\n  in **webtrees**, and have edited your data off-line using software that\n  deletes media objects, then tick this box to merge the current media objects\n  with the new GEDCOM.”_) In most cases you should leave this box **UNCHECKED**.\n* Click “SAVE”. **webtrees** will validate the GEDCOM again before importing.\n  During this process, **webtrees** copies your entire family tree (GEDCOM file)\n  to a 'chunk' table within your database. Depending on the coding of your file,\n  its file size and the capabilities of your server and the supporting software,\n  this may take some time. **No progress bar will show while the data is being\n  copied** and should you navigate away from this page, the process is suspended.\n  It will start again when you return to the Family Tree management page.\n\n## Security\n\n**Security** in _webtrees_ means ensuring your site is safe from unwanted\nintrusions, hacking, or access to data and configuration files. The developers\nof _webtrees_ regard security as an extremely important part of its development\nand have made every attempt to ensure your data is safe.\n\nThe area most at risk of intrusion would be the **/data** folder that contains your\nconfig.ini.php file, and various temporary files. If you are concerned there\nmay be a risk there is a very simple test you can do: try to fetch the file \nconfig.ini.php by typing **``url_to_your_server/data/config.ini.php``** in your web\nbrowser.\n\nThe most likely result is an “access denied” message like this:\n\n    Forbidden\n\n    You don't have permission to access /data/config.ini.php on this server.\n\nThis indicates that the protection built into **webtrees** is working, and no\nfurther action is required.\n\nIn the unlikely event you do fetch the file (you will just see a semicolon),\nthen that protection is not working on your site and you should take some further\naction.\n\nIf your server runs PHP in CGI mode, then change the permission of the **/data**\nfolder to 700 instead of 777. This will block access to the httpd process,\nwhile still allowing access to PHP scripts.\n\nThis will work for perhaps 99% of all users. Only the remaining 1% should consider\nthe most complex solution, moving the **/data** folder out of accessible web\nspace. (**_Note:_** In many shared hosting environments this is not an option anyway.)\n\nIf you do find it necessary, following is an example of the process required:\n\nIf your home folder is something like **/home/username**,\nand the root folder for your web site is **/home/username/public_html**,\nand you have installed **webtrees** in the **public_html/webtrees** folder,\nthen you would create a new **data** folder in your home folder at the same\nlevel as your public_html folder, such as **/home/username/private/data**,\nand place your GEDCOM (family tree) file there.\n\nThen change the **Data folder** setting on the ``Control panel`` -\u003e\n``Website`` -\u003e ``Website preferences`` page from the default **data/** to the new\nlocation **/home/username/private/data**\n\nYou will have **two** data directories:\n\n* [path to webtrees]/data - just needs to contain config.ini.php\n* /home/username/private/data - contains everything else\n\n## Backup\n\nBackups are good. Whatever problem you have, it can always be fixed from a good\nbackup.\n\nTo make a backup of **webtrees**, you need to make a copy of the following\n\n1. The files in the *webtrees/data* folder.\n2. The tables in the database. Freely available tools such as\n   [phpMyAdmin](https://www.phpmyadmin.net) allow you to do this in one click. Alternatively, You can also make a backup running a mysqldump command (just replace the words *[localhost]*, *[username]*, *[password]* and *[databasename]* with your own):\n\n    `mysqldump --host=[localhost] -u [username] -p[password] --databases [databasename] \u003e dump_file.sql`\n\n    Note that '*-p[password]*' goes together with no space in between.\n\nRemember that most web hosting services do NOT backup your data, and this is\nyour responsibility.\n\n## Restore from backup\n\nTo restore a backup on a new server:\n\n1. Follow the steps in [Installation](#installation) to get a clean new installation.\n\n2. Replace the *data* folder with backup copy.\n\n3. Restore your mysql database using phpmyadmin or running the following command line on your database server using your mysqldumpfile (just replace the words *[username]*, *[password]* and *[databasename]* with your own):\n\n    `mysql -u [username] -p[password] [database_name] \u003c [dump_file.sql]`\n\n4. Confirm the file *data/config.ini.php* contains to correct information to connect to the database and update it if needed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisharebest%2Fwebtrees","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffisharebest%2Fwebtrees","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisharebest%2Fwebtrees/lists"}