The summer sprint is over and we are happy to announce the availability of the new stable release of Friendica “Siberian Iris” 2021.09. It contains more then 160 pull requests from seven contributors and updates to several language packages from the translation teams.
For a detailed overview of the changes, please have a look at the CHANGELOG. The highlights of the release are
- scheduled postings (scheduling is done in the permissions of a posting),
- the notification system got an overhaul, and
- admins can now browse the logs more comfortable in the admin panel.
How to Update
Please note: With the release of 2021.09 Friendica does require at least PHP version 7.2 or above. Known issues with PHP 8 are collected in the issue tracker at github.
Updating from old Friendica versions
If you are updating from an older version than the 2020.03 release, please first update your Friendica instance to that version.
Pre-Update Procedures
Ensure that the last backup of your Friendica installation was done recently. We had no problems reported during the upgrade process from 2021.07 to the 2021.09 release candidate, so hopefully you will have a smooth transition.
Using Git
Updating from the git repositories should only involve a pull from the Friendica core repository and addons repository, regardless of the branch (stable or develop) you are using. Remember to update the dependencies with composer as well. So, assuming that you are on the stable
branch, the commands to update your installation to the 2021.09 release would be
cd friendica
git pull
bin/composer.phar install --no-dev
cd addon
git pull
If you want to use a different branch then the stable
one, you need to checkout the branch before your perform the git pull.
Pulling in the dependencies with composer will show some deprecation warning, we will be working on that in the upcoming release.
Using the Archive Files
If you had downloaded the source files in an archive file (tar.gz) please download the current version of the archive from friendica-full-2021.09.tar.gz (sha256) and friendica-addons 2021.09.tar.gz (sha256) and unpack it on your local computer.
As many files got deleted or moved around, please upload the unpacked files to a new directory on your server (say friendica_new
) and copy over your existing configuration (config/local.config.php
and config/addon.config.php
) and .htaccess
files. Afterwards rename your current Friendica directory (e.g. friendica) to friendica_old
and friendica_new
to friendica
.
The files of the dependencies are included in the archive (make sure you are using the friendica-full-2021.09 archive), so you don’t have to worry about them.
Post Update Tasks
The database update should be applied automatically, but sometimes it gets stuck. If you encounter this, please initiate the DB update manually from the command line by running the script
bin/console dbstructure update
from the base of your Friendica installation. If the output contains any error message, please let us know using the channels mentioned below.
Please note, that some of the changes to the database structure will take some time to be applied, depending on the size of your Friendica database.
Known Issues
Update Mon Sept 27th: If you are using MySQL (not MariaDB) the automatic DB structure updates may fail see issue 10768.
Update Mon Oct 4th / 7th: Solved for the full archive downloadable from files.friendi.ca. A node-specific config/local.config.php
file has been inadvertently included in the full archive. Please make sure you either remove it or overwrite it with your own when you perform the update as described above.
How to Contribute
If you want to contribute to the project, you don’t need to have coding experience. There are a number of tasks listed in the issue tracker with the label “Junior Jobs” we think are good for new contributors. But you are by no means limited to these – if you find a solution to a problem (even a new one) please make a pull request at github or let us know in the development forum.
Contribution to Friendica is also not limited to coding. Any contribution to the documentation, the translation or advertisement materials is welcome or reporting a problem. You don’t need to deal with Git(Hub) or Transifex if you don’t like to. Just get in touch with us and we will get the materials to the appropriate places.
Thanks everyone who helped making this release possible and have fun!
3 Comments
Congratulations!
It’s amazing to have a Living Breathing Fa__ebook Alternative. (Right Before they Sink…)
@Michael: I think you are allowed to type Facebook here. Or I did not understand why you used “Fa__ebook” instead.