Configuration¶

Environment Variables¶

All landing page configuration is done via environment variables in .env.

Core Settings¶

Variable	Description	Default
`LANDING_SECRET_KEY`	Flask secret key	Required
`FLASK_ENV`	Environment mode	`production`

Odoo Integration¶

Variable	Description	Default
`ODOO_BASE_URL`	Odoo server URL	`http://odoo:8069`
`ODOO_DB`	Database name	From `DB_NAME`
`ODOO_API_KEY`	REST API key	Required for forms

Helpdesk Integration¶

Variable	Description	Default
`HELPDESK_TEAM_ID`	Odoo helpdesk team ID for ticket routing	`1`

docker-compose.yml Required

This variable must be added to the landing service environment in docker-compose.yml:

landing:
  environment:
    - HELPDESK_TEAM_ID=${HELPDESK_TEAM_ID:-1}

To find your team ID in Odoo: 1. Go to Helpdesk > Configuration > Helpdesk Teams 2. Open the team you want tickets routed to 3. Check the URL - the ID is in the path (e.g., /web#id=3&model=helpdesk.team)

reCAPTCHA¶

Variable	Description	Default
`RECAPTCHA_SITE_KEY`	Public site key	Required
`RECAPTCHA_SECRET_KEY`	Secret key	Required

Get keys from Google reCAPTCHA Admin.

Theme¶

Variable	Description	Default
`LANDING_THEME`	Theme selection	`slate`

Options: blue, slate, earth

Company Information¶

Variable	Description	Example
`COMPANY_NAME`	Business name	`JDX Blinds & Shutters`
`COMPANY_PHONE`	Phone number	`(214) 555-0123`
`COMPANY_EMAIL`	Contact email	`info@jdxblinds.com`
`COMPANY_ADDRESS`	Location	`Dallas, TX`

SEO Meta Tags¶

Variable	Description
`META_TITLE`	Page title
`META_DESCRIPTION`	Meta description

Variable	Description
`SOCIAL_FACEBOOK`	Facebook URL
`SOCIAL_INSTAGRAM`	Instagram URL
`SOCIAL_TWITTER`	Twitter/X URL

Example .env Configuration¶

# Landing Page Configuration
LANDING_SECRET_KEY=your-secret-key-here

# Theme (blue, slate, earth)
LANDING_THEME=slate

# Company Information
COMPANY_NAME=JDX Blinds & Shutters
COMPANY_PHONE=(214) 555-0123
COMPANY_EMAIL=info@jdxblinds.com
COMPANY_ADDRESS=Dallas, TX

# SEO
META_TITLE=JDX Blinds & Shutters - Premium Window Treatments
META_DESCRIPTION=Transform your home with premium blinds, shutters, and shades.

# Social Media
SOCIAL_FACEBOOK=https://facebook.com/jdxblinds
SOCIAL_INSTAGRAM=https://instagram.com/jdxblinds
SOCIAL_TWITTER=

# reCAPTCHA v3
RECAPTCHA_SITE_KEY=6Le...
RECAPTCHA_SECRET_KEY=6Le...

Odoo Configuration¶

Create API Key¶

Go to Settings > Users & Companies > Users
Select the API user
Go to Preferences tab
Under API Keys, click New API Key
Copy the key to ODOO_API_KEY in .env

Required Odoo Modules¶

crm - For lead creation from estimate form
helpdesk - For ticket creation from helpdesk form
restapi - REST API module for external access

Domain Configuration¶

Configure domains in .env:

DOMAIN_LANDING=yourcompany.com
DOMAIN_ERP=erp.yourcompany.com
DOMAIN_PWA=pwa.yourcompany.com
DOMAIN_DOCS=docs.yourcompany.com

Nginx routes traffic based on domain:

Domain	Service
`yourcompany.com`	Landing Page
`erp.yourcompany.com`	Odoo ERP
`pwa.yourcompany.com`	Field PWA
`docs.yourcompany.com`	Documentation