in Alfresco

Alfresco inbound tutorial and telnet instructions


Inbound is supported by alfresco and allows user to send email with attachment to alfresco. In this tutorial we are going to explain how to:

  • Enable alfresco inbound
  • Test if alfresco is receiving emails using telnet

Enabling alfresco inbound

Alfresco even though it supports inbound emails this feature is not enabled by default, in order to enable it you have to set this parameters into your alfresco global properties file


This next few properties are optional

email.server.port=25 #specify your port if this one is taken
email.server.domain=localhost #specify your domain

Property unknownUser is interesting, as if this user exist in this case anonymous alfresco will receive emails from unknown addresses.

Only thing you need to set after this is DNS to when person sends email to alfresco should receive it.

What is the email address for each node?

Each node has emailId property that will be visible when inbound is enabled. Can be seen in the properties of alfresco folder or file.

Email ID & Email Alias


For share to work we have to add some configuration in the share-config-custom.xml

<config evaluator="aspect" condition="emailserver:aliasable">
 <show id="emailserver:alias" />
 <field id="emailserver:alias" />

This will look like this:

Alias in Share

Alias in Share

PS: you need to add aspect aliasable to desired node. This can be done with share manage aspects action.

Test if alfresco inbound feature is working

For testing we need to add user to EMAIL_CONTRIBUTORS group and that user must have email address set.

Second we need to have telnet in your computer, for windows users you can enable your telnet using instructions here.

Lets type some commands and send email to alfresco from console.

1 :Type telnet like so:

open localhost 25

Response from the server will be

220 localhost ESMTP SubEthaSMTP 3.1.6

2: Next we must say helo

helo me

Alfresco will respond with

250 localhost

3: Now we want to send email by typing next command


Email address must be known to the alfresco, or anonymous username will be used if exists.

Server should say

250 Ok

4: Now we will enter who is receiving the email, in this case receiver would be a folder that we know email id or alias value (inbox or 892 in this case)


Server will say :

250 Ok

5: Final part is to specify body of our email using commands like this:


Server will say

354 End data with <CR><LF>.<CR><LF>

We will continue with this ([enter] means press key enter)[enter][enter]
this is email test being sent from alfresco blog.[enter][enter]
. [yes type dot][enter]

Server will respond with something like this if all was ok

250 Ok

Yeeeee we have sent the email to alfresco.

You can find your file in the inbox folder named as the subject in the email you have sent.

Sending email to alfresco with attachments

I have found this here and it works great!

Subject: This is a test mail
Date: Thu, 24 Mar 2011 15:15:29 +0900
MIME-Version: 1.0
Content-Type: multipart/mixed;

This is a multi-part message in MIME format.

Content-Type: text/plain;
Content-Transfer-Encoding: 7bit

This is a test mail.

Content-Type: image/x-png;
Content-Transfer-Encoding: base64
Content-Disposition: inline;




After you paste text above press enter .


Don't be shellfish...Tweet about this on TwitterShare on LinkedInShare on Google+Share on RedditShare on Facebook

Was this helpful ?