Install Steps

Attention: the recommended way to install Noosfero for production usage is using the provided Debian packages on a Debian stable system, following the instructions on HowToInstall.

This page contains alternative methods for installing in other systems, and will be of use if you can't or don't want to use the recommended production setup.

This guide is a compilation of various manuals for different setups. In the source code, there is a more Debian oriented manual in the file INSTALL.

If you simply want to see Noosfero running or want it to run in a production environment, take a look at DebianPackage or others deploy alternatives.

But if you want to install Noosfero and understand how it happens for further modifications and development, then the following "Source code installation" is the right thing for you.

Manual installation

This guide is intended for advanced users and developers.

1. Get the Code

sudo apt-get install git-core
git clone
cd noosfero
git checkout stable
More info at GettingStartedWithNoosferoDevelopment. Prefer the git way to get the code.

Enter the source directory in a shell to run the next steps

2. Dependencies

Using Debian Squeeze

See the apt-get install command in the beggining of the file INSTALL, located in the source code you've just downloaded. You may also use scripts/quick-start for dependencies installation.
sudo apt-get install ruby rake po4a libgettext-ruby-util libgettext-ruby1.8 libsqlite3-ruby rcov librmagick-ruby libredcloth-ruby libwill-paginate-ruby iso-codes libfeedparser-ruby openjdk-6-jre libdaemons-ruby thin tango-icon-theme libhpricot-ruby

You may use a virtual machine or a chrooted environment to install Debian Stable.

Using Debian Wheezy (testing)

Similar to Debian Squeeze, but with slight modifications and workarounds for a Rails 2.x based setup. Eventually, for Wheezy a Rails 3.x based Noosfero (currently developed in a separate branch) is going to be recommended.
sudo apt-get -y install ruby po4a libgettext-ruby libsqlite3-ruby rcov librmagick-ruby libredcloth-ruby libfeedparser-ruby libferret-ruby libdaemons-ruby thin tango-icon-theme libhpricot-ruby
sudo apt-get -y install rails
sudo apt-get -y remove ruby1.9.1
sudo apt-get -y install rubygems
sudo gem install will_paginate --no-ri --no-rdoc -v 2.3.16
The differences are: rake and iso-codes are already installed as dependencies; the default Ruby 1.9 in Wheezy needs to be reset to 1.8; will-paginate needs to be installed as a Gem because the version in Wheezy is too new.

Using other Linuxes/Unixes

If you're using any other Unix-like system (be Linux, *BSD or a Mac OS X), follow DepsWithRVMAndGems

3. Database

Choose one of the options to use as database. You may test them after configuration using script/dbconsole


For development or production, you may use Postgres. Although it is harder to configure, you get closer to the production environment in your development one.

See PostgreSQL.


Warning Due to SQL incompatibilities, since Noosfero 0.43.0, Postgres is the recommended database for development and test environments.

Deprecated SQLite is a very easy to setup, perfect for the lazy in a development environment. See InstallSQLite.

In some rare cases, moving database's data to another DBMS might be useful

4. Populate data

See InstallData.

5. Servers

See InstallServers.

Deploy installation

These guides are intended for delivering Noosfero to final users in a production environment.

See the alternatives at Deploy.

Video tutorials


Read Getting started with Noosfero development, specially about the quick-start and sample-data scripts.

Hi, This is the only solution that works for me. Maybe you can update install steps above. Thanks. Marcelo

How to install Noosfero with chroot in a Debian 6.0.9 squeeze virtual machine. // An "abstract" of smile // I had previously created a directory in user/projects/noosfero

//Command logs: // as root //----------

$ apt-get install schroot debootstrap debian-archive-keyring

// Setup schroot.conf file $ vim /etc/schroot/schroot.conf

[squeeze] description=Debian squeeze (stable) aliases=userdev type=directory directory=/srv/chroot/userdev users=userdev root-groups=root personality=linux preserve-environment=true

$ mkdir -p /srv/chroot/userdev

$ debootstrap squeeze /srv/chroot/userdev/ ... $ schroot -c userdev

$ apt-get install sudo vim

// Setup sudoers $ vim /etc/sudoers usuario ALL = (ALL)ALL $ exit

// as your user // ------------------

$ schroot -c usuario-dev $ su $ apt-get install sudo vim $ apt-get install git $ git clone

$ cd noosfero

$ sudo apt-get install rails rails-ruby1.8 ruby1.8 ruby rake libgettext-rails-ruby1.8 libsqlite3-ruby libpgsql-ruby libmysql-ruby librmagick-ruby libredcloth-ruby libwill-paginate-ruby iso-codes libfeedparser-ruby openjdk-6-jre libdaemons-ruby rcov thin tango-icon-theme libhpricot-ruby

$./script/quick-start … $ script/development // Noosfero didn't run. I had to install more dependencies

$ sudo apt-get install libtidy-ruby libhpricot-ruby libmocha-ruby imagemagick po4a xvfb libxml2-dev libxslt-dev

$./script/quick-start ... $ ./script/sample-profiles // add users

$ ./script/development //run noosfero. User: adminuser pass: admin

-- MarceloFortino - 17 Apr 2014

Add comment
You need to login to be able to comment.
Topic revision: r24 - 17 Apr 2014 - 21:13:38 - MarceloFortino

irc Talk with Devs Now!

Translations: English
Search on Docs:
ActionItem Search:

Copyright © 2007-2014 by the Noosfero contributors
Colivre - Cooperativa de Tecnologias Livres