Skip to content

Latest commit

 

History

History
159 lines (107 loc) · 4.85 KB

quick-install-with-docker.rst

File metadata and controls

159 lines (107 loc) · 4.85 KB
Raw

Quick Install with Docker

Copy the following code and paste it into a file called docker-compose.yaml

version: '3'

services:
    db:
        image: mariadb:10.11
        container_name: nearbeach-db
        ports:
        - 3306:3306
        environment:
        - MARIADB_DATABASE=<<Please fill>>
        - MARIADB_USER=<<Please fill>>
        - MARIADB_PASSWORD=<<Please fill>>
        - MARIADB_ROOT_PASSWORD=<<Please fill>>
        volumes:
        - ./init:/docker-entrypoint-initdb.d
    nearbeach:
        image: robotichead/nearbeach:latest
        container_name: nearbeach
        environment:
        - SECRET_KEY=<<Please fill>>
        - SMTP_EMAIL_HOST=<<Please fill>>
        - SMTP_EMAIL_PORT=<<Please fill>>
        - SMTP_EMAIL_HOST_USER=<<Please fill>>
        - SMTP_EMAIL_HOST_PASSWORD=<<Please fill>>
        - DB_DATABASE=<<Please fill>>
        - DB_USER=<<Please fill>>
        - DB_PASSWORD=<<Please fill>>
        - DB_HOST=nearbeach-db
        - DB_ENGINE=mysql
        - DB_PORT=3306
        - ADMIN_USERNAME=<<Please fill>>
        - ADMIN_EMAIL=<<Please fill>>
        - CSRF_TRUSTED_URLS=<<https://yourdomain.com.au>>
        - ALLOWED_HOSTS=localhost,127.0.0.1
        - AZURE_STORAGE_CONNECTION_STRING=<<Please fill>>
        - AZURE_STORAGE_CONTAINER_NAME=<<Please fill>>
        volumes:
        - .:/ceansuite
        ports:
        - 8000:8000
        - 2525:2525
        command: >
            sh -c "python manage.py wait_for_database &&
                ls -al &&
                python manage.py migrate &&
                python manage.py initadmin &&
                python manage.py runserver 0.0.0.0:8000"
        restart: unless-stopped
        depends_on:
        - db

  1. Inside the docker-compose.yaml file, edit the SECRET_KEY. This will be a large string with symbols, letters and numbers. You can use a generate like https://djecrety.ir/

  2. Inside the docker-compose.yaml file, fill out the following fields appropriately. SMTP is used to send the reset password functionality required to login for the first time.

    • SMTP_EMAIL_HOST
    • SMTP_EMAIL_PORT
    • SMTP_EMAIL_HOST_USER
    • SMTP_EMAIL_HOST_PASSWORD

  3. The administration username/email will be used to log into NearBeach. This will need to be filled out appropriately because changing

    • ADMIN_USERNAME
    • ADMIN_EMAIL

  4. Inside the docker-compose.yaml file, there are two services. One will be for setting up the Database, and the other service will setup NearBeach. You will need to fill out the database connection/details. Please note you will need the same variable value for the following pairs;

    • DB_DATABASE / MARIADB_DATABASE
    • DB_USER / MARIADB_USER
    • DB_PASSWORD / MARIADB_PASSWORD
    • MARIADB_ROOT_PASSWORD

    MARIADB_ROOT_PASSWORD will not have a pair.

  5. Fill out the CSRF_TRUSTED_URLS value. This will need to be the EXACT domain. Please view the examples below

    CSRF_TRUSTED_URLS=https://demo.nearbeach.org

    If you would like to demo NearBeach, please fill out the following

    CSRF_TRUSTED_URLS=http://localhost:8000,http://127.0.0.1:8000

  6. Fill out the ALLOWED_HOSTS. This will be similar to the CSRF_TRUSTED, but without the http and port numbers.

    - ALLOWED_HOST=demo.nearbeach.org

    Alternatively - if using localhost

    - ALLOWED_HOSTS=localhost,127.0.0.1

  7. Use your Azure Blob storage to store uploaded files from NearBeach. If you don't require Azure Blob storage, please delete these two lines;

    - AZURE_STORAGE_CONNECTION_STRING
- AZURE_STORAGE_CONTAINER_NAME

  8. Using a terminal, change directory to the location that you stored the docker-compose file. Run the following command

    docker-compose up -d

    If you would like to specify a project name for your NearBeach instance. Run the following command instead:

    docker-compose up -d --project-name NearBeach

You are now up and running NearBeach in Docker. Visiting the URL you set in the CSRF_TRUSTED_URLS in your browser will take you to NearBeach.

For first time logins, you will need to reset your password. There are two different methods.

  1. Clicking "Reset" password and filling out your email will send you a password reset.

  2. Using a terminal, run the following command:

    docker exec -it <<DOCKER-CONTAINER-NAME>> python3 ./manage.py changepassword <<ADMIN_USERNAME>>

    This will ask for a new password.