Table of Contents
A managment dashboard to make managing active directory easier. It includes some features to work with a hybrid environment that uses office 365 / entra. Built to be simple and secure, it can help accomplish admin tasks in a consistent and auditable way.
Welcome to LenoreAD! This guide will help you set up and run the application using Docker and Docker Compose.
Make sure you have the following installed on your system:
Create a .env file in the root directory of the project. This file will store environment variables required to run the application. Below is an example of the variables you need to define:
DEBUG=0
SECRET_KEY=mysupersecretkey
DJANGO_ALLOWED_HOSTS=localhost
CSRF_TRUSTED_ORIGINS=http://localhost
SQL_ENGINE=django.db.backends.postgresql
SQL_DATABASE=LenoreAD
SQL_USER=LenoreADuser
SQL_PASSWORD=somepassword
SQL_HOST=db
SQL_PORT=5432
DATABASE=postgres
DJANGO_SUPERUSER_PASSWORD=suepervisorpassword
DJANGO_SUPERUSER_EMAIL=someone@somewhere.com
DJANGO_SUPERUSER_USERNAME=supervisor
VITE_API_KEY=someapikey
TIMEZONE=America/New_YorkAdjust these values according to your environment and application requirements.
Create a docker-compose.yml file in the root directory of the project. Below is an example configuration:
services:
frontend:
image: novanglus96/LenoreAD_frontend:latest
container_name: LenoreAD_frontend
networks:
- LenoreAD
restart: unless-stopped
expose:
- 80
env_file:
- ./.env
backend:
image: novanglus96/LenoreAD_backend:latest
container_name: LenoreAD_backend
command: /home/app/web/start.sh
volumes:
- LenoreAD_static_volume:/home/app/web/staticfiles
- LenoreAD_media_volume:/home/app/web/mediafiles
expose:
- 8000
depends_on:
- db
networks:
- LenoreAD
env_file:
- ./.env
db:
image: postgres:15
container_name: LenoreAD_db
volumes:
- LenoreAD_postgres_data:/var/lib/postgresql/data/
env_file:
- ./.env.db
networks:
- LenoreAD
nginx:
image: novanglus96/lenoreapps_proxy:latest
container_name: LenoreAD_nginx
ports:
- "8080:80"
volumes:
- LenoreAD_static_volume:/home/app/web/staticfiles
- LenoreAD_media_volume:/home/app/web/mediafiles
depends_on:
- backend
- frontend
networks:
- LenoreAD
networks:
LenoreAD:
volumes:
LenoreAD_postgres_data:
external: true
LenoreAD_static_volume:
external: true
LenoreAD_media_volume:
external: true-
Start the services:
docker compose up -d
-
Access the application in your browser at
http://localhost:8080.
- Adjust exposed ports as needed for your environment.
- If you encounter any issues, ensure your
.envfile has the correct values and your Docker and Docker Compose installations are up to date.
Enjoy using LenoreAD!
See the full documentation.
- v1.1 Release
- Templates
- Office 365 tools
- Reports
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. Please follow these steps and guidelines to help us maintain a smooth development process.
- Click the Fork button at the top-right of this repository to create your own copy.
- Clone your fork locally.
Create branches following this pattern:
- Features: feature/branch-name - For new features or enhancements.
- Fixes: fix/branch-name - For bug fixes or patches.
Submit pull requests to the appropriate branch based on the stability of your changes:
| Target Branch | Purpose |
|---|---|
| main | Production-ready changes for release. |
| rc | Release candidates for staging releases. |
| alpha | Experimental and unstable changes. |
| beta | More stable than alpha, for broader testing. |
PRs to main and rc branches are for finalized changes intended for the next release. PRs to alpha and beta are for testing and experimental work.
We use semantic commit messages to automate changelog and versioning.
Format:
<type>(optional scope): <short description>| Common types | |
|---|---|
| feat: | A new feature |
| fix: | A bug fix |
| chore: | Changes to build process or auxiliary tools |
| docs: | Documentation only |
| style: | Formatting, missing semicolons, etc; no code change |
| refactor: | Code change that neither fixes a bug nor adds a feature |
| perf: | Performance improvements |
| test: | Adding or fixing tests |
Breaking changes: Add ! after type or scope
feat!: drop support for Node 10
fix(api)!: change endpoint response formatExamples:
- feat: add user profile page
- fix(auth): handle expired tokens gracefully
- chore: update dependencies
- perf: optimize image loading
Before submitting your PR, please ensure:
- Your branch is up to date with the target branch.
- Your code passes all tests and linters.
- You have added or updated tests if applicable.
- Relevant documentation has been added or updated.
- Your PR description clearly explains your changes and references related issues.
Please test your changes locally or in a staging environment before opening a PR. Use alpha or beta branches for testing experimental changes.
Distributed under the MIT License. See LICENSE.txt for more information.
Or
John Adams - Lenore.Apps@gmail.com
Project Link: https://github.com/Novanglus96/LenoreAD
A heartfelt thanks to our Patrons for their generous support! Your contributions help us maintain and improve this project.
Want to see your name here? Support us on Patreon to join our amazing community and shape the future of LenoreAD!
