Download as
Browse Code »

Commit c94fa54f4d9d1f8a8802e0b503da5e5df57c9d6b

Authored by Antonio Terceiro
Committed by Daniela Feitosa
1 parent cc6d42c3
Exists in master and in 29 other branches add_member_task_reject_details, admin_visible_profile, article-list-template, community_notifications, contact_admin_translation, event_fixes, fix_comments_pagination, fix_rails4_organization_ratings, fix_sign_up_form, follow_step_fix, forum_topic_creation, mirror_block_improvements, multi_env_on_remote_user, new_security, noosfero_spb_ci, organization_ratings_improvements, organization_ratings_link_to_profile_stable-spb-1.3, organization_ratings_translations_fix, profile_api_improvements, ratings_minor_fixes, remote_user_fix, send_email_to_admins, stable-spb-1.3, stable-spb-1.3-fixes, stable-spb-1.4, stable-spb-1.5, suggest_rejected_value, web_steps_improvements, xss_terminate_custom_options

Document the need for a working e-mail setup

Showing 1 changed file with 45 additions and 0 deletions   Show diff stats
@@ -155,6 +155,51 @@ Restart postgresql: @@ -155,6 +155,51 @@ Restart postgresql:
155 155
156 # invoke-rc.d postgresql-8.3 restart 156 # invoke-rc.d postgresql-8.3 restart
157 157
  158 +Noosfero needs a functional e-mail setup to work: the local mail system should
  159 +be able to deliver e-mail to the internet, either directly or through an
  160 +external SMTP server.
  161 +
  162 +If you know mail systems well, you just need to make sure thet the local MTA,
  163 +listening on localhost:25, is able to deliver e-mails to the internet. Any mail
  164 +server will do it.
  165 +
  166 +If you are not a mail specialist, we suggest that you use the Postfix mail
  167 +server, since it is easy to configure and very reliable. Just follow the
  168 +instructions below.
  169 +
  170 +To install Postfix:
  171 +
  172 +# apt-get install postfix
  173 +
  174 +During the installation process, you will be asked a few questions. Your answer
  175 +to them will vary in 2 cases:
  176 +
  177 +Case 1: you can send e-mails directly to the internet. This will be the case
  178 +for most commercial private servers. Your answers should be:
  179 +
  180 + General type of mail configuration: Internet site
  181 + System mail name: the name of your domain, e.g. "mysocialnetwork.com"
  182 +
  183 +Case 2: you cannot, or don't want to, send e-mail directly to the internet.
  184 +This happens for example if your server is not allowed to make outbound
  185 +connections on port 25, or if you want to concentrate all your outbound mail
  186 +through a single SMTP server. Your answers in this case should be:
  187 +
  188 + General type of mail configuration: Internet with smarthost
  189 + System mail name: the name of your domain, e.g. "mysocialnetwork.com"
  190 + SMTP relay host: smtp.yourprovider.com
  191 +
  192 +Note that smtp.yourprovider.com must allow your server to deliver e-mails
  193 +through it. You should probably ask your servive provider about this.
  194 +
  195 +There is another possibility: if you are installing on a shared server, and
  196 +don't have permission to configure the local MTA, you can instruct Noosfero to
  197 +send e-mails directly through an external server. Please note that this should
  198 +be your last option, since contacting an external SMTP server directly may slow
  199 +down your Noosfero application server. To configure Noosfero to send e-mails
  200 +through an external SMTP server, follow the instructions on
  201 +http://noosfero.org/Development/SMTPMailSending
  202 +
158 As noosfero user 203 As noosfero user
159 ================ 204 ================
160 205