How to install Noosfero on macOS

Noosfero is a free and open-source web platform for social and solidarity economy networks. In order to install Noosfero on macOS, we will use Homebrew to manage our dependencies and the bundler gem to install the required packages.

Prerequisites

Before you begin, ensure that the following prerequisites are met:

  • You have macOS installed on your machine.
  • You have administrative privileges to install new software.
  • You have a stable internet connection.

Step 1: Install Homebrew

Homebrew is a package manager for macOS that allows us to easily install and manage dependencies. Follow the steps below to install Homebrew:

  1. Open Terminal on your macOS machine.
  2. Run the following command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Wait for the installation to complete.

Step 2: Install the required dependencies

Now that we have Homebrew installed, we can use it to install the dependencies required for Noosfero. Run the following commands in Terminal:

brew install imagemagick
brew install libxml2

Step 3: Install Ruby

Noosfero requires Ruby to run. Follow the steps below to install Ruby:

  1. Open Terminal on your macOS machine.
  2. Run the following command to install rbenv:
brew install rbenv
  1. Once rbenv is installed, run the following command to update your shell configuration:
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
  1. Restart your Terminal session to apply the changes.
  2. Run the following command to check if rbenv is working properly:
rbenv versions

  1. You should see a message that says "No Ruby version specified yet." This means that rbenv is working properly.

  2. Run the following command to install the latest version of Ruby:

rbenv install 3.1.0
  1. Set the default Ruby version to the one you just installed by running:
rbenv global 3.1.0

Step 4: Install Bundler and Noosfero

Now that we have Ruby installed, we can use the bundler gem to install the required packages for Noosfero. Run the following commands in Terminal:

gem install bundler
git clone https://gitlab.com/noosfero/noosfero.git
cd noosfero
bundle install

Step 5: Configure and start Noosfero

Noosfero is now successfully installed on your macOS machine. To start the Noosfero server, run the following commands in Terminal:

bundle exec rails server

You should see a message that says "Listening on tcp://0.0.0.0:3000". This means that the Noosfero server is running and can be accessed by visiting http://localhost:3000 in your web browser.

Congratulations! You have successfully installed Noosfero on your macOS machine.