AHEM will accept any email sent to it (on the domains specified in the configuration), and create an ad hoc mailbox as needed. Then just browse to its UI, enter the mailbox name and you'll see the emails contained in the mailbox. That's it. No authentication. No account creation.

nodejs > v10 
angular cli installed globally (npm install -g @angular/cli)
mongodb

# clone the repository
git clone https://github.com/o4oren/Ad-Hoc-Email-Server.git
cd Ad-Hoc-Email-Server
npm install
# builds the project.
npm run build:ssr

# there are other, convenience options for build and run in development mode.
# for development:
npm run startDev

# for prod:
# will run the backend which will also serve the front end from the `dist` folder.
node ahem.js

AHEM use several environment variables for configuration. These can be set up using a .env file (see dotEnv docuemntation). An example file is located in the root of the project. If a .env file is no found, you can just set these items as env variables. A docker-compose file is also present in the root of the project, showing how these configuration properties can be set in a docker compose set up or passed to a docker image.

These are the available parameters:

• Build docker: docker build -t o4oren/ahem .

• Build FE only: docker build -t o4oren/ahem-universal . -f Dockerfile_ssr

• Run docker with external properties: docker run -v /[local.dotEvn.path]/.env:/opt/ahem/.env -it -p 3000:3000 -p 25:25 -d o4oren/ahem

• Sign into docker: docker exec -it ahem sh

• start docker stackand swarm: docker swarm init && docker stack deploy -c docker-compose.yml ahemswarmc

• stop docker stack: docker stack rm getstartedlab

• In addition, sample kubernetes yaml config files are provided as reference in the k8s folder. These are provided as is.

• for debugging - run mongo on docker locally: docker run -d -p 27017:27017 -v ~/data:/data/db mongo

• docker-compose build
• docker-compose up

The AHEM color palette is available here.

A brief list of RESTful resources:

AHEM server is ready for Google Analytics. By default, when you set it up, it will not send information to GA though. If you'd like to enable GA, add the snippet below in your /client/index.html file's head section, and rebuild the project. Replace XX-XXXXXXXXX-X with your GA id.

  <script>
    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
        (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
    })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

    ga('create', 'XX-XXXXXXXXX-X', 'auto');
  </script>

• Error page when user/email doesn't exist
• Empty mail page
• Landing page
• Errors on find user/email in api
• Error on non existing user / message
• Routing for messages
• Read/unread icons
• Attachments
• Allow delete emails
• Migrate to mongodb
• Update missing emails page and loading circles
• Sort out logging
• Separate mailbox view from email view pages
• Separate server and webapp properties
• Better home page
• Add apis to get mailbox references from email, get mailbox and email counts - both general and in mailbox context

• Oren Geva

See also the list of contributors who participated in this project.

This project is licensed under the Apache v2 License - see the LICENSE.md file for details