; Maximum amount of memory a script may consume (128MB)                       
; http://php.net/memory-limit                                                   
memory_limit = 128M

• uncomment the last four lines in .htconfig
  
• check if either php.out does exist or create it
  
• make sure php.out is writable for your webserver
  
• you may rename php.out to any name that feels more appropriate to you
  
• select the appropriate logging level for your use case
  

// Uncomment the following 4 lines to turn on PHP error logging.
error_reporting(E_ERROR | E_WARNING | E_PARSE ); 
ini_set('error_log','php.out'); 
ini_set('log_errors','1'); 
ini_set('display_errors', '0');

The Permission Categories App

• enable the Permission Categories app at /apps/available
  
• you can either use the predefined categories or create your own ones at /permcats
  
• at your channels' privacy settings you can select a default Permission Category to be assigned to any new connection
  
• at each connection's privacy settings you can change the currently assigned Pernission Category
  

• when renaming a PC it is dublicated instead of renamed
  
• at the connection settings PCs are always displayed as "Default" instead of the one assigned. You need to compare the actual permissions with your PCs.
  
• when changing a setting within a PG it should be automatically applied to all relevant connections
  
• there should be an easy way to bulk check / bulk assign PGs to connections, maybe similar to Privacy Groups
  

• Debian basic installation (only deviation in my install was including "basic" and SSH-server, which actually makes sense as you need a way to remote control your system, and fail2ban t give you a little protection for brute force login attempts. Chose your passwords wisely but never enter them into foreign services. Though this may be useful to get some impession on password security.)
  
• Existing domain, correctly configured and pointing to your server
  

• The Basics: Install the required dependencies:
  apt install openssh-server git apache2 mariadb-server php-fpm php-curl php-gd php-mbstring php-xml php-mysql php-zip imagemagick certbot python-certbot-apache php-fpm fail2ban
  
  
• Webserver Apache: Create vhost file /etc/apache2/sites-available/hubzilla.conf and enable vhost, enable the required apache module rewrite. You need to replace example.com with your own domain name.
  MyDomain=example.com
  Then paste this into your shell.
  

  cat > /etc/apache2/sites-available/hubzilla.conf << EOF
  <VirtualHost *:80> 
      ServerAdmin webmaster@localhost
      ServerName $MyDomain
      DocumentRoot /var/www/hubzilla
      ProxyPassMatch ^/(.*\.php(/.*)?)$ unix:/run/php/php7.3-fpm.sock|fcgi://localhost/var/www/hubzilla
      <Directory />
          Options FollowSymLinks
          AllowOverride All
      </Directory>
      <Directory /var/www/>
          Options Indexes FollowSymLinks 
          AllowOverride All
          Order allow,deny
          allow from all
      </Directory>
      ErrorLog ${APACHE_LOG_DIR}/hubzilla_error.log
      LogLevel warn
      CustomLog ${APACHE_LOG_DIR}/hubzilla_access.log combined
  </VirtualHost>
  EOF

  
  Enable the new vhost
  a2ensite hubzilla
  You might want to disable the default site (enabled automatically upon installation):
  a2dissite 000-default.conf
  Enable apache modules rewrite
  a2enmod rewrite
  Enable apache modules mpm_event and proxy
  a2enmod mpm_event
  Restart apache2 in order to activate all these changes
  systemctl restart apache2
  
• Download Hubzilla: clone the Hubzilla Git repository and chown everything to be writable to the webserver account www-data
  cd /var/www/ ; git clone https://framagit.org/hubzilla/core.git hubzilla; chown -R www-data. hubzilla;
  
• To create the database set your desired password first:
  MyPassword=SuperSecret
  Then actually create the database:
  

  mysql -u root -e "create database hubzilla ; CREATE USER 'hubzilla'@'localhost' IDENTIFIED BY '$MyPassword'; GRANT ALL PRIVILEGES ON hubzilla.* to 'hubzilla'@'localhost';"

  
  
• SSL Encryption: create the letscencrypt certificates in order to use SSL and have certbot automatically configure your apache vhost to use SSL. Just follow the instructions. Let certbot configure your vhost to use SSL.
  certbot
  
• setup a cronjob
  echo "*/10 * * * *    www-data cd /var/www/hubzilla; /usr/bin/php Zotlabs/Daemon/Master.php Cron > /dev/null 2>&1"  >> /etc/crontab
  
• Install the official addons:
  util/add_addon_repo https://framagit.org/hubzilla/addons addons-official
  

Install Hubzilla on an existing web server

• Create database

  You need to manually create the database. For that you can use any tool you like, be it PHPMyAdmin or similar. Or just good old CLI.
  Please substitute <myhub> for your own data, and especially the password <myhubpw> must be changed.
  create database myhub ; CREATE USER 'myhub'@'localhost' IDENTIFIED BY 'myhub'; GRANT ALL PRIVILEGES ON test.* to 'myhub'@'localhost' IDENTIFIED BY 'myhubpw'; GRANT ALL PRIVILEGES ON myhub.* to 'myhub'@'localhost';
  Note: Postgres is also supported if you prefer that one, though the initial development happened for MySQL / MariaDB.
  

• Git clone the repository

  
  Git cloning the software onto your server is the recommended way to put the Hubzilla software on your server, as this is required for the recommended way to update and maintain your hub.
  Just go into your web root and issue
  git clone https://framagit.org/hubzilla/core.git myhub
  

• Browser based installatiaon

  
  Now you are ready to call your Hubzilla domain from the browser. It will also launch into the installation process.
  
  

  Hubzilla Server Setup: System Check

  
  You will be greeted by a system check that will tell you if there are any packages left you will need to install. As is to be expected, you will not be able to proceed before you resolve all possible issues.
  Please note: The upload file size information is just that, an information. You will be able to proceed no matter how small or huge that value is.
  
  
  

  Hubzilla Server Setup: Database Connection

  
  As mentioned, you can also opt for using Postgres. This is to be selected below.
  
  
  

  Hubzilla Server Setup - Site Settings

  
  The basic site settings include just three values:
  
  
  
  • Your designated admin account email-address:
    You are surely going to create an account once you finish your installation. It is recommended to set up the first account using exactly this address as using this address will make the corresponding account an admin account.
    
  • The website URL:
    The URL should be https://... if it is not, please stop and install a certificate, for example let's encrypt. The easiest way is just to install certbot and then to call certbot and follow the on-screen help. It's pretty good. Or ask your admin / your service provider.
    
  • Your time zone:
    To select your time zone you can also start typing the one you are looking for, for example the city "Berlin" if you are living in Germany and therefore want your hub to run on a German time zone.
    
  ,
  
  

  Hubzilla Server Setup: Installation Succeeded

  
  Now you should get the final success message which includes  a link to the registration page and the information that you will need to set up a cronjob for Hubzilla. Read on.
  
  

  Create your admin account and channel

  
  As mentioned above, follow the given link to the registration page. This article explains the process of account registration and channel creation in more detail. Please go there for more information.
  
  

  Cronjob

  
  As you can see in the screenshot above, you are being referred to the file install/INSTALL.txt for further information. You can read the extended information in section 8. This is just a short version: Add something like the below line to your /etc/crontab, though you will certainly adapt this to your own needs, this is only a hint and cannot be used literally.
  
  
  
  • Certainly you can chose other values than every ten minutes.
    
  • You will supposedly substitute www-data with your web server's system account for any non-Debian based systems.
    
  • Check that your php executable is really at /usr/bin/php, if not please change appropriately.
    
  • Check your document root and change the example /var/www/myhub to your path.
    
  • The rest should remain as is, Zotlabs/Daemon/Master.php Cron > /dev/null 2>&1
    
  
  */10 * * * *    www-data cd /var/www/myhub; /usr/bin/php Zotlabs/Daemon/Master.php Cron > /dev/null 2>&1
  

What is a Hubzilla account and what is a Hubzilla channel?

• Within Hubzilla you register an account, for which you will need a working EMail address. An account is the requirement to create a channel (or more).
  
• A Hubzilla channel is comparable to your online identity. A channel contains all your things and items, such as postings, articles, web sites, wikis, file storage, photo albums and more. Even though we assume you want to start using Hubzilla using it as a social network, there are quite a few different predefined channel configurations. You may change your channel at a later date.
  There are:
  
  
  
  • social channels with varying privacy settings
    
  • forums with varying privacy settings
    
  • feed channels, also with varying privacy settings
    
  • a soap box function for announcement only channels
    
  • group repositories for teams and group colaboration
    
  
  For more information on the individual channel configurations see this article on Hubzilla Channel Roles. But you can also do so on a later date.
  

Register an Hubzilla account and create a channel

• Go to the register page

  
  You can get to the account register page from your (or any) hub's front page.
  Please note: Not all hubs are open for registrations. If you happen upon such a hub, you will be automatically linked to an overview of open hubs. There you will be able to select a hub for you. It is recommended to take hubs that are as up to date as possible and therefore obviously maintained.
  This is what such an overview may look like:
  
  

• Create an account

  
  To register an account you only need a valid EMail address which will be used to possibly recover your password and to send out notifications for events such as new posts, connections etc. You can certainly configure these mailings and tailor them to your needs, or suppress them completely.
  A note to admins:
  If you want to register your account as an admin account, please make sure you use the very same address you entered during the Hubzilla Server Setup.
  
  

• Create a channel for your account

  
  Your account remains absolutely unusable unless you create a channel.
  
  
  
  • Channel name:
    This is the name for your channel as people who visit your page can see it. It may be your name, the name of your project, club or whatever. May contain a wide range of alphanumerical and special characters including blanks. Example: "my channel name"
    
  • Channel short name
    This will be part of the URL to your channel and therefore is restricted to alphanumeric characters. Example: mychannelname which will be used for your channel's url, such as https://myhub.rocks/mychannelname
    
  
  
  

• Complete Your Channel's Information: Edit Profile Details

  
  On the last page you can add further information to your chanel's profile. The profile is a kind of information page for your channel, an "about". All information are voluntary, your channel will also work if you just go on.
  Note:
  If you are on a desktop, you get a few shortcut links on your right, to upload a profile photo, view the directory etc. Actually viewing the directory may be a good idea as there you will possibly find a few possible first connections. As mentioned, it is absolutely up to you to fill out as little or as detailed information on your profile as you like. Please be aware, that as of now your profile is public and can be seen by anyone. But it is recommended to state a few general aspects, such as interests and a profile photo so that people kind of get an idea what your channel is about.
  
  

• social channels with varying privacy settings
  
• forums with varying privacy settings
  
• feed channels
  
• a soap box function for announcement only channels
  
• group repositories