README

Installation

Idno is under active development and requires PHP 8.3+ with selected extensions, together with a supported database backend. You can find detailed installation instructions here: http://docs.idno.co/en/latest/install/index.html

Installing from packages

Unofficial install packages, which are periodically built from the latest code, are available: https://www.marcus-povey.co.uk/known/

Installing from Github

You can opt to check out the work-in-progress development code from the git repository: https://github.com/idno/idno

• Check out the repo: git clone https://github.com/idno/idno.git
• Fetch dependencies: cd idno; composer install

Installing with composer

You can install Idno directly from composer using: composer create-project idno/idno

Optionally, you can install the latest bleeding edge code the same way: composer create-project idno/idno -s dev

Setting up the async pipeline

By default, Idno processes events synchronously — that is, things like Webmention pings, syndication, and ActivityPub delivery all happen inside the web request that triggered them. This works, but it makes page saves slow and means a timeout or crash loses the work.

Enabling the asynchronous queue moves all of that into a background worker. The web request just drops an event into the database and returns immediately; the worker picks it up and processes it separately.

This is required for ActivityPub. Follow-accept delivery, post distribution to followers, and update/delete propagation are all dispatched through the queue. If the worker is not running, those events sit in the database unprocessed and remote servers will never receive them.

1. Enable the async queue

Add this line to your config.ini:

event_queue = 'AsynchronousQueue'

Without this line (or with the default SynchronousQueue), all events are processed inline during the web request.

2. Start the event queue worker

sudo -u www-data IDNO_DOMAIN='your.domain' ./idno.php service-event-queue

How it works: The worker runs an infinite loop. Each cycle it:

1. Queries the database for up to 50 pending events.
2. Dispatches each one via an internal HTTP call to /service/queue/dispatch/{id}, which triggers the event handler (e.g., signing and POSTing an ActivityPub activity to a remote inbox).
3. Runs garbage collection to remove completed events older than 5 minutes.
4. Sleeps for --interval seconds, then repeats.

If the worker dies, queued events pile up in the database but are not lost. They will be processed once the worker is restarted.

3. Keep it alive with systemd (recommended)

The worker must stay running permanently. The simplest way is a systemd service unit. Create /etc/systemd/system/idno-queue.service, taking care to replace the values here with your own paths, users, and domains:

[Unit]
Description=Idno async event queue worker
After=network.target

[Service]
Type=simple
User=www-data
Environment=IDNO_DOMAIN=your.domain
WorkingDirectory=/var/www/idno
ExecStart=/var/www/idno/idno.php service-event-queue #replace with your path
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Then enable and start it:

sudo systemctl daemon-reload
sudo systemctl enable --now idno-queue

Check status any time with:

sudo systemctl status idno-queue
sudo journalctl -u idno-queue -f   # tail the logs

Alternative: use cron instead of systemd

If you don't have access to systemd (e.g. shared hosting), you can use cron instead. The --once flag makes the worker process one batch of pending events and exit, which is ideal for cron:

* * * * * sudo -u www-data IDNO_DOMAIN='your.domain' /var/www/idno/idno.php service-event-queue --once >> /var/log/idno-queue.log 2>&1

This processes pending events once per minute. Events may take up to 60 seconds to be delivered (compared to ~1 second with the systemd worker above).

4. Run the periodic cron service (optional)

If you need periodic background tasks (triggered via cron/minute, cron/hourly, and cron/daily events), start the cron service the same way:

sudo -u www-data IDNO_DOMAIN='your.domain' ./idno.php service-cron

You can create a second systemd unit (idno-cron.service) following the same pattern as above if you want it managed automatically.

5. After updates — restart the workers

When you update Idno core or any plugins, restart both services so they pick up the new code:

sudo systemctl restart idno-queue idno-cron

Support us

• Star us on GitHub
• Like us on alternativeto.net
• Contribute

Get support

• Try the open source mailing list: https://groups.google.com/forum/#!forum/known-dev

Community links

• Learn more and sign up to get updates: https://idno.co
• Full project documentation: http://docs.idno.co/

For details on contributing to the Idno project, please read CONTRIBUTING.md.

Contributors

This project exists thanks to all the people who contribute. [Contribute].

See contributors on GitHub.

Copyright and License

Except for included third-party projects, Idno is (c) The Open Community Company LLC.

Unless otherwise stated, Idno is licensed under the Apache Software License 2.0. See LICENSE for more information.

Idno logos are (c) Idno, Inc. Permission from Idno, Inc is required to use the Idno name or logo as part of any project, product, service, domain or company name, except as included in official themes distributed by Idno.

Logos of external services are (c) their respective owners. All rights reserved.

Third party libraries are licensed separately.

Idno also contains

• Bootstrap, which is distributed under the Apache 2.0 license. Source: https://github.com/twitter/bootstrap
• jQuery, which is distributed under the MIT License. Source: https://github.com/jquery/jquery
• Portions of Symfony, which is distributed under the MIT license.
  • EventDispatcher. Source: https://github.com/symfony/EventDispatcher
  • HttpFoundation. Source: https://github.com/symfony/HttpFoundation
  • Console. Source: https://github.com/symfony/console
• ToroPHP, which is distributed under the MIT License. Source: https://github.com/anandkunal/ToroPHP/
• Fork Awesome, which is distributed under the Open Font License, version 1.1: https://github.com/ForkAwesome/Fork-Awesome
• Steve Clay's AutoP, which is distributed under the MIT License. Source: https://code.google.com/p/mrclay/
• Aaron Parecki's Webmention Client, which is distributed under the Apache 2.0 license. Source: https://github.com/aaronpk/mention-client
• Barnaby Walters's Microformats 2 Parser, which is distributed under the MIT License. Source: https://github.com/indieweb/php-mf2
• FitVids.js, which is distributed under the WTFPL License. Source: http://fitvidsjs.com/
• Leaflet.js, which is distributed under the BSD 2-Clause License. Source: http://leafletjs.com/
• SwiftMailer, which is distributed under the MIT License. Source: https://github.com/swiftmailer/swiftmailer
• Antwort, an email template which is distributed under the MIT License. Source: https://github.com/internations/antwort
• Mention.js, a Bootstrap user at-mention library, which is distributed under the MIT License. Source: https://github.com/jakiestfu/Mention.js
• MediaElement.js, a cross-browser media player, which is distributed under the MIT License. Source: https://github.com/johndyer/mediaelement
• Simplepie, a feed parser, which is distributed under the BSD 3-Clause License. Source: https://github.com/simplepie/simplepie/
• Bootstrap Toggle, which is distributed under the MIT License. Source: http://www.bootstraptoggle.com/
• TinyMCE, a rich text editor, which is distributed under the LGPL License. Source: https://github.com/tinymce/tinymce
• The Paypal Bootstrap Accessibility Plugin, which is distributed under the BSD 3-Clause License. Source: https://github.com/paypal/bootstrap-accessibility-plugin
• HTMLPurifier, which is distributed under the LGPL License. Source: http://htmlpurifier.org
• Wavesurfer, which is distrubuted under a Creative Commons Attribution 3.0 Unported License. Source: https://github.com/katspaugh/wavesurfer.js
• MongoDB-PHP-Library, which is distributed under the Apache 2 Licence. Source: https://github.com/mongodb/mongo-php-library
• Exif-js, which is distributed under the MIT Licence. Source: https://github.com/exif-js/exif-js
• PHP-OGP, distributed under the GPL2 Licence. Source: https://github.com/mapkyca/php-ogp

Thank you

Thanks to BrowserStack for providing the infrastructure that allows us to test in real browsers.