Intertidal

Requirements

• Docker Desktop

Initialize the Application

docker compose up -d --build

Intertidal Frontend will be available at http://localhost:8080/ Intertidal Admin will be available at http://localhost:8080/admin/

Install/Switch the admin theme

# Bootstrap
docker exec -it intertidal_app python manage.py loaddata admin_interface_theme_bootstrap.json

# Django
docker exec -it intertidal_app python manage.py loaddata  admin_interface_theme_django.json

# Foundation
docker exec -it intertidal_app python manage.py loaddata  admin_interface_theme_foundation.json

# U.S. Web Design Standards
docker exec -it intertidal_app python manage.py loaddata  admin_interface_theme_uswds.json

Create your superuser

docker exec -it intertidal_app python manage.py createsuperuser

Enter username, email, and password as prompted

example:

docker exec -it intertidal_app python manage.py createsuperuser --username="admin" --email="[email protected]"

General Usage

Starting the Application

docker compose up -d

Stopping the Application

docker compose down

Rebuilding the Application (after upstream or js/python package changes)

docker compose up -d --build

Viewing logs (each container)

docker logs -f intertidal_app
docker logs -f intertidal_db
docker logs -f intertidal_mail

Accessing the Application

http://localhost:8080/

Accessing the Database

Command line:

docker exec -it intertidal_db mysql -u intertidal -ppassword intertidal

Through a database management tool:

• Host:127.0.0.1
• Port: 15432
• Username: intertidal
• Password: password

Accessing Mailhog (catches emails sent by the app)

http://localhost:8025/

Database Migrations

Migrate up to latest

docker exec -it intertidal_app python manage.py migrate

Create new migrations

docker exec -it intertidal_app python manage.py makemigrations

Updating Application Dependencies

Pip (python)

Manage python dependencies in requirements.txt

All packages should be locked to a specific version number if possible (Ex Django==4.2.7) Some special packages cannot be locked and should be noted as such (Ex psycopg[binary])

After making changes, you need to run pip or rebuild the image

docker exec -it intertidal_app pip install -r requirements.txt
# or
docker compose up -d --build

Update a package

Edit version number in requirements.txt with new locked version number

Ex pip==24.0.0

docker exec -it intertidal_app pip install -r requirements.txt
# or
docker compose up -d --build