Git Product home page Git Product logo

mandrill's Introduction

Mandrill

Multi-user web front-end for managing a Munki repository. If you're here because of MailChimp, my apologies but this isn't the Mandrill you're looking for. /wavehand

Mandrill is a NodeJS web application written using the Meteor framework. It supports one database engine: MongoDB. There are no plans to support other engines, but fear not, mandrillctl will install and secure MongoDB for you. If you already have MongoDB running on your server via homebrew, you should probably remove that installation first, or use an alternate server.

mandrill git-log

Installing Mandrill on Linux

Most of the instructions below only apply to OS X. If you're using Linux, see the step through wiki guide for Ubuntu or CentOS to get started.


Installation Prerequisites

  • Host operating systems that have been tested include OS X, OS X Server, Ubuntu Server, and CentOS, but any flavor of Linux or Unix should suffice.
  • NodeJS >= v0.10.22 with NPM (both tools are in the 'Universal' link for the Mac OS X Installer .pkg).

Installing mandrillctl OS X Only

Installation kicks off with the installation of the command line tool for Mandrill, mandrillctl. Since you're here, you've already got npm and node installed, so all you need to do is...

sudo npm install -g mandrillctl

The -g means it's installing mandrillctl globally instead of within your home directory. It's also going to drop a symlink in your search path which you probably wouldn't be able to do without running it through sudo.

Installing Mandrill On OS X

mandrillctl makes it pretty simple to install MongoDB + Mandrill and have your server running in no time. In general, there are four commands you'll want to run to make this happen:

# Install mandrill
sudo mandrillctl --install

# Defaults to port 80.
# If you specify a port that's in use by another process,
# mandrillctl let you know.
sudo mandrillctl --set-http-port 3001

# Set your hostname (sub directories aren't supported)
sudo mandrillctl --set-http-host http://mandrill.example.com

# Don't forget to turn on the lights before you go
sudo mandrillctl --start

That's it! Using the example values above, you should now be able to open your browser to http://mandrill.example.com:3001 and login!

Initial Login

Like any good web app, the default username and password are admin and admin. I hope it's obvious that you should change this password immediately.

Updating Mandrill

Mandrill has a built in command for updating to the current release

sudo mandrillctl --update

Additional Mandrill commands

You can get a list of mandrillctl options by issuing:

mandrillctl --help

As of version 0.7.1 the following options are available:

-h, --help                     output usage information
-i, --install                  Alias for --update
-u, --update                   Installs or updates Mandrill and its
                               requirements.
                               NOTE: If you need to use a proxy server, set 
                               the http_proxy environment variable prior to
                               running this command.
                               `export http_proxy=http://proxy.server:port/`
-f, --force                    Use with -u or -i to bypass prompts
-s, --status                   Displays the status of the Mandrill and MongoDB
                               server processes.
--stop                         Halts the MongoDB and Mandrill servers
--start                        Starts the MongoDB and Mandrill servers
--restart                      Restarts the MongoDB and Mandrill servers
--no-logo                      Don't include the Mandrill logo and version in
                               the output
--get-http-port                Displays the port on which Mandrill will listen
--set-http-port <port>         Sets the port on which Mandrill will
                               listen
--get-http-host                Displays the host/fqdn for the Mandrill server.
--set-http-host <http://fqdn>  Sets the host/fqdn for the
                               Mandrill server
--uninstall                    Uninstalls Mandrill, MongoDB + databases.
                               mandrillctl will not uninstall itself.

Questions?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.