Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Jeci - Stats Alfresco on Database

Build Status

Description / Features

This software is made to perform some statistics on Alfresco Database.

This software uses queries to perform statistics on content stored in Alfresco. We directly access sql database for performance reason. In consequence, this tool can works with offline server or sql backup dump. We don't need to access to disk "content store" or Solr indexes.


These features are described below

  • Alfresco Disk Usage
  • Stores
  • Export


Tried with :

  • Alfresco Enterprise and Community 4.x - MySQL / Oracle (only enterprise)
  • Alfresco Enterprise and Community 5.x - MariaDB / PostgreSQL


  • Java 8
  • oracle JDBCDriver

Quick start

Local Build

git clone
cd stats-alfresco-on-database
./gradlew clean build
cp src/test/resources/ build/libs/
cd build/libs/
java -jar jeci-saod-0.?.?.war

Then go to http://localhost:8080 user admin / adm1n

With Docker Compose

git clone
cd stats-alfresco-on-database
docker-compose -f docker/docker-compose.yml up --build -d

Then go to http://saod.docker.localhost/ user admin / adm1n

Alfresco Disk Usage

This tool prints size of directories in Alfresco.

  • First we need to load data from the databases. (This may take a while.)
  • Then you would browse directories


Print Childs Nodes size


  • This version considers files with thumbnails are folders.
  • Problem loading sql file inside war application, for the moment we need sql files readable on disk


This tool permit to see all files and directories in your database.


  • Node DB Id
  • NodeRef
  • Local Size
  • Aggregate Size
  • Full Size


This tool permit to download a CSV File with informations about all files and directories from the page where you are.

Download modes

  • Files
  • Directories
  • Files & Directories


Depend on the download mode you choose.

  • Type
  • Name
  • Full Size
  • Full path


  • SAOD use externalized configuration from Spring Boot Framework.

  • Use file from src/test/resources/ as sample configuration

  • We use a local HSQLDB to store data localy. See sqldb/local

  • You may occure probleme with jmx on jetty, add this parameters.

  • You can define port or context path with these parameters:
  • You can define default sorting with this two parameters:

You can sort on the four columns : "name", "local", "aggregate", "full". default is set to "none". For the sort "name" column, you can define the language to use with saod.sort.lang parameter.


Security is perform with Spring Security. There is two roles ROLE_ADMIN and ROLE_USER.

  • ROLE_ADMIN can load date from Alfresco database
  • ROLE_USER can only read content.

Default users are :

  • admin / admin with ROLE_ADMIN
  • user / user with ROLE_USER

You can choose login and password for this default account with these parameters:

These parameters must be define before the first boot, or change directly in the local HSQL database, for example using DBeaver. Take care to first stop application before editing the local database and shutdown DBeaver before restart application.


We tried computation script with big Alfresco Database (~500GB of office files) all compute takes 67 seconds on my computer.

Future Plans

  • Add support to Postgresql (done)
  • UI "Alfresco Disk Usage"
    • Print "association name" instead of NodeRef when available
    • Print date of last update on alfresco
    • Add row ".." to go on parent folder(done)
    • Add number of file in folder and tree
    • Link in "Add count of files"
  • New Component
    • "Alfresco Disk Usage" report as PDF
    • UI to create and manage local user
    • Add REST interfaces to make javascript UI
  • Authentication based on Alfresco user local account
  • Translation in French and other languages (with your help)
  • Adding Unit Tests and Load Tests


Copyright 2016 Jeci - Jérémie Lesage

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

This work may reference software licensed under other open source licenses, please refer to these respective works for more information on license terms.

You can’t perform that action at this time.