FeministWiki:Technical documentation: Difference between revisions

no edit summary
No edit summary
(2 intermediate revisions by the same user not shown)
Line 8: Line 8:
!IP            !! FQDN                        !! Host          !! Purpose                !! Ports
!IP            !! FQDN                        !! Host          !! Purpose                !! Ports
|-
|-
|85.214.208.60 ||            feministwiki.org ||              || Wiki                    || 80, 443
|85.214.206.20 ||            feministwiki.org ||              || Wiki                    || 80, 443
|-
|-
|85.214.208.60 ||        www.feministwiki.org || www          || Wiki                    || 80, 443
|85.214.206.20 ||        www.feministwiki.org || www          || Wiki                    || 80, 443
|-
|-
|85.214.208.60 ||      ldap.feministwiki.org || ldap          || LDAP                    || -
|85.214.206.20 ||      ldap.feministwiki.org || ldap          || LDAP                    || -
|-
|-
|85.214.208.60 ||      blogs.feministwiki.org || blogs        || Blogging                || 80, 443
|85.214.206.20 ||      blogs.feministwiki.org || blogs        || Blogging                || 80, 443
|-
|-
|85.214.208.60 ||      chat.feministwiki.org || chat          || Web-client for XMPP    || 80, 443
|85.214.206.20 ||      chat.feministwiki.org || chat          || Web-client for XMPP    || 80, 443
|-
|-
|85.214.208.60 ||      forum.feministwiki.org || forum        || BBS Forum              || 80, 443
|85.214.206.20 ||      forum.feministwiki.org || forum        || BBS Forum              || 80, 443
|-
|-
|85.214.208.60 ||      mail.feministwiki.org || mail          || Web-client for Mail    || 80, 443
|85.214.206.20 ||      mail.feministwiki.org || mail          || Web-client for Mail    || 80, 443
|-
|-
|85.214.208.60 ||      files.feministwiki.org || files        || File storage            || 80, 443
|85.214.206.20 ||      files.feministwiki.org || files        || File storage            || 80, 443
|-
|-
|85.214.208.60 ||      imap.feministwiki.org || imap          || IMAP                    || 993
|85.214.206.20 ||      imap.feministwiki.org || imap          || IMAP                    || 993
|-
|-
|85.214.208.60 ||      pop3.feministwiki.org || pop3          || POP3                    || 995
|85.214.206.20 ||      pop3.feministwiki.org || pop3          || POP3                    || 995
|-
|-
|85.214.208.60 ||      smtp.feministwiki.org || smtp          || SMTP                    || 25, 465, 587
|85.214.206.20 ||      smtp.feministwiki.org || smtp          || SMTP                    || 25, 465, 587
|-
|-
|85.214.208.60 ||      xmpp.feministwiki.org || xmpp          || XMPP                    || 5222, 5223, 5269, 5270, 5443, 7777
|85.214.206.20 ||      xmpp.feministwiki.org || xmpp          || XMPP                    || 5222, 5223, 5269, 5270, 5443, 7777
|-
|-
|85.214.208.60 ||        irc.feministwiki.org || irc          || IRC                    || 6697
|85.214.206.20 ||        irc.feministwiki.org || irc          || IRC                    || 6697
|-
|-
|85.214.208.60 ||    account.feministwiki.org || account      || Account operations      || 80, 443
|85.214.206.20 ||    account.feministwiki.org || account      || Account operations      || 80, 443
|}
|}


Line 128: Line 128:


Note that whenever you run the {{C|letsencrypt-refresh}} script, it will momentarily stop the web server.  This means you're causing a short outage of the web-based services of the FeministWiki whenever you run the script.
Note that whenever you run the {{C|letsencrypt-refresh}} script, it will momentarily stop the web server.  This means you're causing a short outage of the web-based services of the FeministWiki whenever you run the script.
== Ubuntu package repositories ==
Currently, FeministWiki runs on Ubuntu 16.04 LTS (Xenial), which has rather old Apache and PHP packages.  We use the Ubuntu PPAs {{C|ondrej/apache2}} and {{C|ondrej/php}} to get newer versions.
For F-Droid packages, we use the {{C|fdroid/fdroidserver}} Ubuntu PPA.


== Services ==
== Services ==
Line 151: Line 145:
Software: MediaWiki
Software: MediaWiki


The wiki uses a [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] installation located at {{C|/var/www/wiki/w}}.  It uses the [https://www.mediawiki.org/wiki/LDAP_Stack LDAP Stack] extension for login management, and the "Short URL" feature is enabled.  The wiki uses the SQL database called "feministwiki" and the SQL user of the same name.
The wiki uses a [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] installation located at {{C|/var/www/fw/wiki/w}}.  It uses the [https://www.mediawiki.org/wiki/LDAP_Stack LDAP Stack] extension for login management, and the "Short URL" feature is enabled.  The wiki uses the SQL database called "feministwiki" and the SQL user of the same name.


The default wiki is in English.  Parallel wiki installations for different languages are supported via a combination of Apache's URL rewriting, and conditional branches in the {{C|LocalSettings.php}} file of the MediaWiki installation:
The default wiki is in English.  Parallel wiki installations for different languages are supported via a combination of Apache's URL rewriting, and conditional branches in the {{C|LocalSettings.php}} file of the MediaWiki installation:
Line 178: Line 172:
Software: WordPress (multisite)
Software: WordPress (multisite)


This is an installation of WordPress in {{C|/var/www/blogs}}, with the "multisite network" feature enabled on a path-basis, so users can have their own blogs on URLs like {{C|blogs.feministwiki.org/janedoe}}.  LDAP authentication is enabled via the AD/LDAP plugin from miniOrange.
This is an installation of WordPress in {{C|/var/www/fw/blogs}}, with the "multisite network" feature enabled on a path-basis, so users can have their own blogs on URLs like {{C|blogs.feministwiki.org/janedoe}}.  LDAP authentication is enabled via the AD/LDAP plugin from miniOrange.


Users from LDAP who log in for the first time are automatically registered as "Subscriber" accounts, and the admin can change their WordPress role "Author" to allow publishing.
Users from LDAP who log in for the first time are automatically registered as "Subscriber" accounts, and the admin can change their WordPress role "Author" to allow publishing.
Line 189: Line 183:
Software: Converse.js
Software: Converse.js


The web-interface for the FeministChat uses the full-screen "Impress" variant of the [https://conversejs.org/ Converse.js] XMPP client.  The hosted HTML and JS files are located at {{C|/var/www/chat}}, although they load Converse.js as an external script from upstream, which is why the self-hosted HTML and JS are very minimal.
The web-interface for the FeministChat uses the full-screen "Impress" variant of the [https://conversejs.org/ Converse.js] XMPP client.  The hosted HTML and JS files are located at {{C|/var/www/fw/chat}}, although they load Converse.js as an external script from upstream, which is why the self-hosted HTML and JS are very minimal.


=== Forum ===
=== Forum ===
Line 196: Line 190:
Software: phpBB
Software: phpBB


The forum uses a [https://www.phpbb.com/ phpBB] installation located at {{C|/var/www/forum}}.  Most configuration of phpBB, including LDAP authentication, is done through its administration panel.  The style used by the forum is a minimally changed "ProSilver Dark".  The forum uses the SQL database called "feministforum" and the SQL user of the same name.
The forum uses a [https://www.phpbb.com/ phpBB] installation located at {{C|/var/www/fw/forum}}.  Most configuration of phpBB, including LDAP authentication, is done through its administration panel.  The style used by the forum is a minimally changed "ProSilver Dark".  The forum uses the SQL database called "feministforum" and the SQL user of the same name.


=== Mail (web interface) ===
=== Mail (web interface) ===
Line 203: Line 197:
Software: Roundcube
Software: Roundcube


The web-interface for the FeministMail uses the [https://roundcube.net/ Roundcube] mail client, installed at {{C|/var/www/mail}}.  It uses a FeministWiki-branded modification of the new "elastic" style.
The web-interface for the FeministMail uses the [https://roundcube.net/ Roundcube] mail client, installed at {{C|/var/www/fw/mail}}.  It uses a FeministWiki-branded modification of the new "elastic" style.


=== Files ===
=== Files ===
Line 210: Line 204:
Software: Nextcloud
Software: Nextcloud


FeministFiles is a [https://nextcloud.com/ Nextcloud] installation with some branding, and LDAP authentication, installed at {{C|/var/www/files}}.
FeministFiles is a [https://nextcloud.com/ Nextcloud] installation with some branding, and LDAP authentication, installed at {{C|/var/www/fw/files}}.


=== IMAP ===
=== IMAP ===
Line 263: Line 257:
Software: custom
Software: custom


This custom web interface hosted at {{C|/var/www/account}} lets you complete several tasks related to FeministWiki membership, such as changing your account settings, resetting your password, or adding a new member.  It also contains a form to request membership.  The interface is written in HTML, CSS, PHP, and C.
This custom web interface hosted at {{C|/var/www/fw/account}} lets you complete several tasks related to FeministWiki membership, such as changing your account settings, resetting your password, or adding a new member.  It also contains a form to request membership.  The interface is written in HTML, CSS, PHP, and C.