How to Install Noosfero on Debian

Noosfero is an open-source web platform that allows you to create and manage social networks, online communities, and other web-related collaborative tools. This tutorial will guide you through the process of installing Noosfero on a Debian server.

Pre-requisites

Before we begin, you will need to have the following items:

1. A Debian server with root access.
2. Git installed on your Debian server.
3. Ruby v2.6.2 installed on your Debian server.

Installation Steps

1. Install required packages:

   $ sudo apt-get update && sudo apt-get upgrade
   $ sudo apt-get install build-essential git redis-server postgresql postgresql-server-dev-all imagemagick libmagickcore-dev libmagickwand-dev libxslt-dev libxml2-dev libpq-dev libsqlite3-dev nodejs sqlite3
   

2. Download the Noosfero source code:

   $ git clone https://gitlab.com/noosfero/noosfero.git
   

3. Install bundler:

   $ gem install bundler
   

4. Install Noosfero's dependencies:

   $ cd noosfero
   $ bundle install
   

5. Create and configure the database:

   $ cp config/database.yml.example config/database.yml
   

6. Configure the PostgreSQL database:

   $ sudo -u postgres createuser noosfero --no-createdb --no-superuser --login --no-inherit --encrypted --pwprompt
   $ sudo -u postgres createdb -O noosfero noosfero_production
   

7. Create the database schema:

   $ RAILS_ENV=production bundle exec rake db:create
   $ RAILS_ENV=production bundle exec rake db:migrate
   $ RAILS_ENV=production bundle exec rake db:seed
   

8. Set up Apache HTTP server:

   $ sudo apt-get install apache2 libapache2-mod-passenger
   $ sudo a2enmod rewrite
   

9. Create a Noosfero virtual host:

   Step 1: Create a new file noosfero.conf in /etc/apache2/sites-available. Paste the following configuration into it:

   <VirtualHost *:80>
      # Use your domain instead of <domain-name>
      ServerName <domain-name>
   
      DocumentRoot /path/to/noosfero/public
   
      # Configure Apache to use Passenger
      PassengerEnabled On
      PassengerAppEnv production
      PassengerAppRoot /path/to/noosfero
      PassengerRuby /usr/bin/ruby
      <Directory /path/to/noosfero/public>
            AllowOverride all
            Options -MultiViews
      </Directory>
   
      # Log configuration
      ErrorLog ${APACHE_LOG_DIR}/noosfero_error.log
      CustomLog ${APACHE_LOG_DIR}/noosfero_access.log combined
   
      # SSL configuration (Optional)
      # SSLCertificateFile /path/to/ssl.crt
      # SSLCertificateKeyFile /path/to/ssl.key
      # SSLCertificateChainFile /path/to/ssl_chain.crt
   </VirtualHost>
   

   Step 2: Enable the Noosfero virtual host by running:

   $ sudo a2ensite noosfero
   

10. Restart Apache HTTP server:

    $ sudo service apache2 restart
    

11. Access Noosfero in your web browser:

    Open your web browser and navigate to http:// and you should see the Noosfero installation page.

Conclusion

Congratulations, you have successfully installed Noosfero on your Debian server! You can now customize and configure Noosfero by logging in as an administrator through the UI interface. Good luck with your new social network platform!