Zum Inhalt der Seite gehen


stuck in installation


Dear !Friendica Support

I'm currently trying to setup a local instance of Friendica for testing and evaluation (first time install) and I'm stuck at step 5 of the installer. After I entered the admins email address, selected timezone and system language, when I click Next, I get a white page (with the "wrong" URL also). The server delivered HTML and CSS etc., but no content to display for the browser. Also the URL path suddenly changes from /install?pass=4 to /index.php?pagename=install (as if rewriting stopped working or there is an issue with the base URL).

No database tables are created, but I can confirm that I entered correct data since if I enter wrong data (server, username, password, database) I get the same behaviour directly after that step where I entered the wrong data.

I try to install Friendica on a dedicated server (in a LXC container), base is a very basic Debian 12 install with additional deb packages to fulfill the requirements given on the official Requirements page. I have root shell access on that Debian installation.

  • Apache httpd 2.4
  • PHP 8.2
  • MariaDB 10.11.6
  • various packages for all the PHP plugins

I got Friendica via git from the stable branch (in hope to have less hassle there, I evaluate this for setting up a community of 10-50 users, maybe growing), let composer run without errors (just some maybe usual warnings about composer version and no longer supported plugins).

I ensured that Apache has the rewrite module installed and allows .htaccess configs for it.

I copied the .htaccess-dist to .htaccess.

I created a dedicated DB user and database for Friendica (additionally I installed phpMyAdmin on that machine to make administering and checking the database easier for me).

I did not install a TLS certificate for the server as it is only for local testing and not intended for outside access - and if I will change that, I probably will have an external reverse proxy handle that.

I checked the availability of all PHP plugins with a small extra page that just calls phpinfo(). (I'm not an expert in PHP but from past experiences with other PHP based software I know that it helps during setup but has to be removed ASAP, especially when going public.)

On the first page of the installer, I get two warnings: one about TLS (which was expectable as I didn't activate it) and one that URL rewrite doesn't work. I don't know why I get that second one - I managed to find the code that checks this, it expects HTTP status 204 of some internal URL and when I call this URL from my local machine it gets that expected answer and also a curl call on the machine where I install Friendica gives that expected answer. Let alone the fact, that the redirect from / to /install is working over all the steps (I found out the hard way how it looks like when rewrite doesn't work, since I first had configured Apache wrong).

I also checked that mail sending works. I only want to receive mail on that test machine, I configured postfix accordingly, tested it with sendmail and with a short snippet that calls PHPs [code]mail()[code] function locally - in both cases I got the email delivered as expected.

Now I don't have a clue where to look further. I don't want to start debugging or reverse engineering, for the current phase of my evaluation that's too much effort for me, so please please help me to continue my experiment.

Where could I look for error messages? (Already checked syslog and Apache error log files.)
What config could I have done wrong? Is the "stable" version not installable from scratch?

TIA, cyberbrain

Friendica Support hat dies geteilt.

Als Antwort auf M.Scheriau

Quick update: browser debugger showed on the page 4 of the installer that the hidden inputs for system-url, database-hostname, database-username, database-password and database-database all have an empty value. I think this could be a problem for step 5?

Friendica Support hat dies geteilt.

Als Antwort auf M.Scheriau

@M.Scheriau

Have you had a look at the alternative instalation routine isung the console like describbed in /help/Install#Option+B%3A+Run+the+automatic+install+script:
friendica.io/help/Install#Opti…

Also make sure that .htaccess is renamed and that /tmp/yourdomainname belongs to www-data

I just had troubles with the standrard install and managed to get it done with the console.
Tha I got stuck wih the first admin profile registry and solved it as described here:
forum.friendi.ca/display/0ac89…


@Friendica Support

Hi there,
just installed a new instances, actually on this very VPS as a name-based virtual hosting, it's a standard github pull of the stable branch 2024.12.

There were some strange issues with creating the local.config.php, like the install procedure didn't accept/write the mysql data into local.config.php. Same if it took that data from a prepared config.php. That data was presented in the install page but I couldn't accept and go on with the installation. So I created a local.config.php with the console and that went well.

Now I got stuck after creating the admin user in the new user option.
I don't get ea registry mail so I can't log in because I have no password.
The site itself doesn't display the option of register users anymore, I guess a first log on by the admin is required.

Actually I have no idea why this instance here does have email support and the new one doesn't.
Is there a way to activate the php mailer addon?

How do I solve this?
Can I retrieve the password form the DB with the console?


Als Antwort auf M.Scheriau

Thanks @utopiArte , I even opened a GitHub ticket where it was confirmed that the manual installer is broken. Tried the scripted version (that you also recommended) and finally it worked. But I found out the hard way that "root@friendica.local" is not accepted as valid email address on registration (although I setup my test machine to actually deliver mail to this address). The Docker image probably uses some "magic" (aka not so prominently documented feature) to turn off the email validation.

BTW I also didn't receive the registration email in 3 of 4 cases of registration, I simply used the "forgot password" function in that case with the known mail address, this always worked. Retrieving the password from the DB would be a big security issue, you always have to create a new one.

Friendica Support hat dies geteilt.

Als Antwort auf M.Scheriau

On the email delivery @M.Scheriau, I guess php mailer (or something like that) has to be present in the first place to make that work from the get go, at least after several intents.

Retrieving the password from the DB would be a big security issue, you always have to create a new one.


Yes.
Password change is (of course) always kinda mandatory.
Point is that it was the only way to get access in the first place.

All that said, and no idea about docker or that kind of installations:
In general from my experience of now like 14 years of setting up friendica, ultimately fruitless intents trying to make it work in shared hosting (a setup option ultimately abandoned by the coders), and now ultimately happily on an own VPS, once you have it up and running it is works fine and is an excellent choice, up to a certain amount of users (50 to max 500 maybe depending on the hardware).

In any case for the peace of mind and and reliability I'd probably recommend old stable for "working" environment.
Perhaps a second installation to support the dev efforts could be a good choice for the admin himself.

Als Antwort auf M.Scheriau

@Tobias

I even opened a GitHub ticket where it was confirmed that the manual installer is broken.
@annando
Sadly there is a problem with the installation script. Please perform an installation via the command line, see here:


That's a real bummer.
Shouldn't that be mentioned in release tag, release notes and installation information Tobias?

Install docs
github.com/friendica/friendica…
Release tag
github.com/friendica/friendica…
Release notes
forum.friendi.ca/display/39bbe…

@M.Scheriau


Friendica 2024.12 released


We are very happy to announce the availability of the new stable release of Friendica “Interrupted Fern” 2024.12. In addition to several improvements and new features, this release contains the fix for the broken installation wizard.

The highlights of Friendica 2024.12 are

  • added exporter for prometheus,
  • we dropped the support of OStatus (the predecessor of ActivityPub) after evaluating the amount of active servers/contacts that are still only using this protocol, and deprecated the fancybox addon
  • Friendica is now REUSE compliant and supports FEP-67ff

For details, please the CHANGELOG file in the repository.

What is Friendica


Friendica is a decentralised communications platform, you can use to host your own social media server that integrates with independent social networking platforms (like the Fediverse or Diaspora*) but also some commercial ones like Tumblr and BlueSky.

How to Update

Updating from old Friendica versions


If you are updating from an older version than the 2023.12 release, please first update your Friendica instance to that version as it contained some breaking changes.

Pre-Update Procedures


Ensure that the last backup of your Friendica installation was done recently.

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 2024.12 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 than the stable one, you need to fetch and 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


Due to unforseen changes in the CI not possible at the moment.

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 this update might run for days.

Known Issues


At the time of writing this, none with 2024.12

But the development branch is currently rather unstable and should be used with caution as the development diverged far (for Friendica terms) from the now stable branch. We will let our very valued ALPHA testers when the dev team things that the development branch is stable enough again.

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 especially to all the new contributors to Friendica, and have fun!


friendi.ca/2025/01/01/friendic…


Hallo! Diese Seite verwendet nur die allernötigsten Cookies, damit du angemeldet bleibst und alles reibungslos funktioniert. Wir legen großen Wert auf Datenschutz und sammeln keine unnötigen Daten. Viel Spaß auf Friendica.io