Skip to content

camerahub/camerahub

Repository files navigation

CameraHub

CameraHub is a web app for film photography that can be used to track cameras, lenses, accessories, films, negatives and prints, to fully catalogue a collection of photographic equipment as well as the pictures that are made with them.

It replaces an earlier command-line project, called PhotoDB, which has now been deprecated.

Installing CameraHub

There are several ways of installing CameraHub, depending on your needs:

Configuring CameraHub

CameraHub requires almost no additional config to run with default settings. However it is insecure in this configuration so at least CAMERAHUB_SECRET_KEY and CAMERAHUB_PROD must be set if you are running in production.

The following environment variables are supported:

CAMERAHUB_ADMIN_EMAIL

Email address for the admin account Default: admin@example.com

CAMERAHUB_ADMIN_PASSWORD

Password for the admin account Default: admin

CAMERAHUB_DB_ENGINE

Database engine Default: django.db.backends.sqlite3

CAMERAHUB_DB_HOST

Database hostname or IP address if an engine other than SQLite is configured

CAMERAHUB_DB_NAME

Database schema or path to SQLite db db/db.sqlite3

CAMERAHUB_DB_PASS

Database password if an engine other than SQLite is configured

CAMERAHUB_DB_PORT

Database port if an engine other than SQLite is configured

CAMERAHUB_DB_USER

Database username if an engine other than SQLite is configured

CAMERAHUB_PROD

Enable Django production mode Default: false

CAMERAHUB_SECRET_KEY

Random secret value. The default string is for testing only and is insecure in production. Generate a new one here Default: OverrideMe!

CAMERAHUB_EMAIL_BACKEND

Email backend Default: django.core.mail.backends.filebased.EmailBackend

CAMERAHUB_EMAIL_USE_TLS'

Enable TLS for SMTP

CAMERAHUB_EMAIL_USE_SSL'

Enable TLS for SMTP

CAMERAHUB_EMAIL_HOST

SMTP server hostname

CAMERAHUB_EMAIL_HOST_USER

SMTP server username

CAMERAHUB_EMAIL_HOST_PASSWORD

SMTP server password

CAMERAHUB_EMAIL_PORT

SMTP server port number

CAMERAHUB_FROM_EMAIL

From email address Default: noreply@camerahub.info

CAMERAHUB_DOMAIN

Site domain Default: camerahub.info

CAMERAHUB_STATUS_URL

URL for a status page

Fixtures

Base data is supplied as fixtures and must be manually imported after installation. These are not idempotent so should only be run once.

This data includes things like EXIF exposure programs, film formats, etc that are required to make CameraHub useful.

poetry run python manage.py loaddata --app schema Condition ExposureProgram Format Manufacturer Filmstock MeteringMode MeteringType Mount NegativeSize Process ShutterSpeed

There is also some test data like cameras and negatives which shouldn't be imported into a production deployment.

See also