Fork me on GitHub

Maraschino installation instructions

These installation instructions are for Linux (specifically Debian) but should be easily adaptable for other distributions. Depending on your permissions you may need to run some (or all) of these commands as a superuser (i.e. prefix "sudo" to them).

Instructions for other OSes coming soon.

  1. Make sure that you have Python installed.

  2. Clone the Maraschino repository.

    You can find it on github: https://github.com/mrkipling/maraschino

    You might want to clone it into /opt/maraschino (although you can clone it elsewhere if you like). The rest of this guide will assume that you have cloned it there, like so:

    git clone https://github.com/mrkipling/maraschino.git /opt/maraschino
  3. Copy initd to /etc/init.d/maraschino:

    cp /opt/maraschino/initd /etc/init.d/maraschino
  4. Copy default to /etc/default/maraschino:

    cp /opt/maraschino/default /etc/default/maraschino
  5. Optional: edit /etc/default/maraschino using your choice of text editor

    This is only required if you have cloned Maraschino somewhere other than /opt/maraschino, in which case you need to change APP_PATH.

    You can also change the port that Maraschino listens on (the default is 7000) by changing PORT.

  6. Make /etc/init.d/maraschino executable:

    chmod a+x /etc/init.d/maraschino
  7. Add it to the startup items:

    update-rc.d maraschino defaults
  8. Start the server:

    /etc/init.d/maraschino start

That's it! Maraschino should now be available on the port that you specificed (default 7000), and should automatically start when you boot your system.