Skip to content

Quick Start

Get up and running with the Odoo 15 ERP system in 5 minutes.

Prerequisites

This guide assumes you've completed Installation. If not, do that first.

1. Start Services

# Verify configuration
./production_deploy.sh config

# Start all services
./production_deploy.sh start

# Verify services are running
./production_deploy.sh status

2. Access the System

Service URL Credentials
Odoo ERP http://localhost:8016 admin / admin (default)
Landing Page http://localhost No auth required (public)
Field PWA http://localhost:8000 Odoo user credentials
Documentation http://localhost:8002 No auth required

Test Environment Defaults

Type Value Used For
User Login admin / admin Odoo web interface
Master Password admin_test_2025 Database management
DB Password odoo_test_2025 PostgreSQL connection

3. First Login to Odoo

  1. Open http://localhost:8016
  2. Login with default credentials:
  3. Email: admin
  4. Password: admin
  5. Change password immediately: Settings → Users → Admin → Change Password

Change Default Password

The admin/admin credentials are Odoo defaults. Change them after first login.

4. Configure Your Company

Navigate to: Settings → Users & Companies → Companies

Update the default company with your details:

Field Example
Company Name Your Company LLC
Street 123 Main Street
City Austin
State Texas
Country United States
Phone +1 555-123-4567
Email info@example.com

5. Install Essential Modules

Via Odoo Interface

  1. Go to Apps menu
  2. Remove "Apps" filter (click X)
  3. Search and install:
  4. sale_management - Sales
  5. crm - CRM
  6. helpdesk - Helpdesk (if available)

Via Command Line

# Install multiple modules at once
docker compose exec odoo odoo \
  -i sale_management,crm,contacts \
  --stop-after-init \
  -d $DB_NAME

# Or use deployment script for single module
./production_deploy.sh update-module justcall_sms

6. Create Your First User

  1. Go to Settings → Users & Companies → Users
  2. Click Create
  3. Fill in:
  4. Name: User's full name
  5. Email: user@example.com
  6. Access Rights: Select appropriate groups
  7. Click Save
  8. Click Send Password Reset Instructions

7. Test the Landing Page

  1. Open http://localhost
  2. Verify homepage loads with company branding
  3. Test the Free Estimate form (creates CRM opportunity)
  4. Test the Helpdesk form (creates support ticket)

Landing Page Configuration

The landing page requires Odoo API key and reCAPTCHA configuration. See Landing Page Setup.

8. Test the Field PWA

  1. Open http://localhost:8000
  2. Login with Odoo credentials
  3. Verify dashboard loads

PWA Requires Configuration

Full PWA functionality requires Odoo API configuration. See PWA Setup.

9. Quick Commands Reference

Service Management

# Start/Stop/Restart
./production_deploy.sh start
./production_deploy.sh stop
./production_deploy.sh restart

# Restart specific service
./production_deploy.sh restart-service odoo

# Check status and health
./production_deploy.sh status
./production_deploy.sh health

# View logs
./production_deploy.sh logs odoo

COMPOSE_FILE in .env

The .env file contains COMPOSE_FILE which automatically loads the correct compose files. No need to specify -f flags.

Database Operations

# Access Odoo shell
./production_deploy.sh odoo-shell

# Access PostgreSQL shell
./production_deploy.sh db-shell

# Backup database
./production_deploy.sh backup

Module Management

# Update module via deployment script
./production_deploy.sh update-module module_name

# Install module directly
docker compose exec odoo odoo -i module_name --stop-after-init -d $DB_NAME

# Upgrade module directly
docker compose exec odoo odoo -u module_name --stop-after-init -d $DB_NAME

10. Common First Tasks

Add a Contact

  1. Go to Contacts menu
  2. Click Create
  3. Enter details and Save

Create a Lead

  1. Go to CRM → Leads
  2. Click Create
  3. Enter lead information
  4. Save

Create a Sales Quotation

  1. Go to Sales → Quotations
  2. Click Create
  3. Select customer
  4. Add products
  5. Save or Send by Email

Troubleshooting

Can't Login?

# Reset admin password via Odoo shell
./production_deploy.sh odoo-shell
>>> env['res.users'].browse(2).write({'password': 'newpassword'})
>>> env.cr.commit()

Module Not Found?

# Update module list
docker compose exec odoo odoo -u base --stop-after-init -d $DB_NAME

# Restart Odoo
./production_deploy.sh restart-service odoo

Service Won't Start?

# Check status
./production_deploy.sh status

# Check logs for errors
./production_deploy.sh logs odoo

# Force recreate
docker compose up -d --force-recreate odoo

Next Steps