Webtrees is an open-source genealogy website software with powerful features and intuitive user interface. In this tutorial, we will guide you through the process of installing Webtrees on the latest version of Fedora CoreOS.
Before we begin with the installation of Webtrees, we need to make sure that Docker is installed on our system.
To install Docker, follow these steps:
Access the terminal or command-line interface and log in as a root user.
Run the following command to install Docker:
$ rpm-ostree install docker
After the installation is complete, start the Docker service by running:
$ systemctl enable --now docker.service
We need to create a Docker network to ensure that the Webtrees container can communicate with the database container.
To create a Docker network, follow these steps:
Run the following command to create a Docker network:
$ docker network create webtreenet
Webtrees requires a database backend to store and retrieve data. In this tutorial, we will be using MariaDB.
To install MariaDB, follow these steps:
Run the following command to create a MariaDB container:
$ docker run --name mariadb -e MYSQL_ROOT_PASSWORD=<ENTER_PASSWORD_HERE> -v mariadbstorage:/var/lib/mysql --network webtreenet -d mariadb:latest
Replace <ENTER_PASSWORD_HERE>
with a strong root password for your MariaDB instance.
Verify that the MariaDB container is running by running:
$ docker ps
Log in to MariaDB using the following command:
$ docker exec -it mariadb mysql -p
Enter the root password when prompted.
Create a new database and user for Webtrees:
CREATE DATABASE webtreedb;
GRANT ALL PRIVILEGES ON webtreedb.* TO 'webtreeuser'@'%' IDENTIFIED BY '<ENTER_PASSWORD_HERE>';
FLUSH PRIVILEGES;
Replace <ENTER_PASSWORD_HERE>
with a strong password for the Webtrees database user.
Now that Docker, the Docker network, and the MariaDB backend are set up, we can proceed with the installation of Webtrees.
To install Webtrees, follow these steps:
Run the following command to create a Webtrees container:
$ docker run -d --name webtrees -p 80:80 -e WT_DB_PASSWORD=<ENTER_PASSWORD_HERE> -e WT_DB_DATABASE=webtreedb -e WT_DB_HOST=mariadb -e WT_DB_USERNAME=webtreeuser --network webtreenet webtrees/webtrees:latest
Replace <ENTER_PASSWORD_HERE>
with the password you set for the Webtrees database user.
Verify that the Webtrees container is running by running:
$ docker ps
Access your server using your domain name or IP address, followed by /setup.php
. For example, http://example.com/setup.php
.
Follow the on-screen instructions to set up your Webtrees website.
After the setup is complete, remove the setup.php
file by running:
$ docker exec -it webtrees rm /var/www/html/setup.php
Congratulations! You have successfully installed Webtrees on Fedora CoreOS using Docker containers. You are now ready to start building your family tree and exploring the many features offered by Webtrees.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!