Get Started with EBAMS

Quick start guide to begin managing your assets

Prerequisites

Python 3.8+

Python 3.8 or higher required

pip

Python package installer

Git

Version control system

Installation

Clone the Repository

git clone <repository-url>
cd asset_management

Create Virtual Environment

# Create virtual environment
python -m venv venv

# Activate (Linux/Mac)
source venv/bin/activate

# Activate (Windows)
venv\Scripts\activate

Install Dependencies

pip install -r requirements.txt

Run the Application

python app.py
The application will automatically:
  • Initialize the database with all required tables
  • Create critical system data
  • Insert debug/demo data for testing
  • Start the development server at http://localhost:5000

First Login

Navigate to http://localhost:5000/login and use the default credentials:

Username

admin

Password

admin

Important: Change the default admin password after first login in production environments.

Advanced Build Options

EBAMS supports command-line flags for controlling database initialization:

# Build all phases (recommended)
python app.py

# Build without demo data
python app.py --no-debug-data

# Build database only (no server start)
python app.py --build-only

# Build specific phases
python app.py --phase1    # Core foundation only
python app.py --phase2a   # Core + asset details
python app.py --phase2b   # Core + asset details + auto-creation

Docker Deployment

Deploy EBAMS using Docker Compose:

# Start the application
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the application
docker-compose down

The application will be available at http://localhost:5000

Next Steps

Explore Features

Learn about all the capabilities EBAMS offers

View Features

Understand Modules

Deep dive into each integrated module

View features

Learn More

Discover the system architecture and design

Learn More

Ready to Login?

Start managing your assets with EBAMS

Go to Login