Installation

In order to run an instance on your system, you need to install docker, docker-compose and npm on your system. Once those dependancies are installed, you need to ask yourself what kind of instance you want to run ; is it a development environment, or a production one. If production, will it be only on localhost, or globbally available. Before digging into the installation process, make sure you've read the wiki entry about the managment script. Now that you are all clear about how you will install BeerCrackerz, let's wee how to proceed.

Whatever the kind of environment you want to setup, please first run the two following commands :

• $ git clone https://github.com/MesseBasseProduction/BeerCrackerz to clone the source code on your system
• # chmod +x ./bc.sh to give the managment script execution permission :

Development installation

Aside from installing docker, docker-compose and npm, the development environment is pretty straightforward to build.

• run $ ./bc.sh -i dev to setup the associated environment file
• run $ ./bc.sh -b dev to build BeerCrackerz docker images
• run $ ./bc.sh -s dev to start the application
• create the super user with $ docker exec -it beer_crackerz_back python manage.py createsuperuser
• run $ npm run watch to look for changes in .js and .scss files

Production installation

As we mentionned previously, there is two way to build a BeerCrackerz production environment ; local or not. Let's first see how to install BeerCrackerz to run on a production environment globally available.

Standard production

For a standard production, you must ensure that, aside from installing docker, docker-compose and npm, you also have a domain availabe (and access to its DNS records), a functionnal mail address and both a MailJet API key* and a MailJet API secret*. Those information will be asked when installing BeerCrackerz using managment script.

• run $ ./bc.sh -i prod to setup the associated environment file
• run $ ./bc.sh -b prod to build BeerCrackerz docker images
• run $ ./bc.sh -s prod to start the application
• create the super user with $ docker exec -it beer_crackerz_back python manage.py createsuperuser
• configure your system web server (or reverse proxy) according to used parameters
• configure the domain DNS records to point at your instance

* On next releases, BeerCrackerz will handle itself the mail server so it doesn't rely on an external service.

Local production

The local production is mostly made to test developments and how they will later behave on a production enviromnent. To properly install a local production, you must ensure that, aside from installing docker, docker-compose and npm, you also have a mail address, a MailJet API key and a MailJet API secret*. Those information will be asked when installing BeerCrackerz using managment script.

• clone the repository on your system ;
• give managment script execution permission : # chmod +x ./bc.sh
• run $ ./bc.sh -i locprod to setup the associated environment file
• run $ ./bc.sh -b locprod to build BeerCrackerz docker images
• run $ ./bc.sh -s locprod to start the application
• create the super user with $ docker exec -it beer_crackerz_back python manage.py createsuperuser

* On next releases, BeerCrackerz will handle itself the mail server so it doesn't rely on an external service.

Instance administration

This entry is only a guide to install BeerCrackerz. To learn how to manage an instance in the long run, please read the Administration wiki entry.