FOSSology is an open source license compliance software system and toolkit. As a toolkit you can run license, copyright and export control scans from the command line. As a system, a database and web ui are provided to give you a compliance workflow. License, copyright and export scanners are tools used in the workflow.
Switch branches/tags
Clone or download
mcjaeger Merge pull request #1236 from siemens/contrib/fixUnifiedROS
fix(unifiedreport): add default count as 0 in result of scan

review-by:michael.c.jaeger@siemens.com
tested-by:michael.c.jaeger@siemens.com
Latest commit c6743d5 Nov 9, 2018
Permalink
Failed to load latest commit information.
.github docs(issue): Issue, PR template for new requests Jul 5, 2018
debian docs(changelog): updating changelog files Nov 1, 2018
install Merge pull request #1226 from GMishx/feat/libjson-cpp Oct 31, 2018
pbconf fix(pb): general correction to enable rpm-based packages Dec 19, 2017
src fix(unifiedreport): add default count as 0 in result of scan Nov 5, 2018
utils Merge pull request #1207 from robertvolkmann/chore/xenial-vagrant-box Oct 17, 2018
.dockerignore feat(docker): Implemented multi-staged build. Sep 16, 2018
.editorconfig chore(editorconfig): change indent_style and size May 8, 2017
.gitignore Merge pull request #1215 from siemens/contrib/fixPhpunutTestCases Oct 30, 2018
.travis.yml feat(copyright): Use package based dependency for json Oct 31, 2018
CHANGELOG.md docs(changelog): updating changelog files Nov 1, 2018
CONTRIBUTING.md docs(CONTRIBUTING): Made required changes in note Aug 28, 2018
Dockerfile feat(copyright): Use package based dependency for json Oct 31, 2018
LICENSE docs(LICENSE): Create LICENSE to reflect in git May 22, 2018
Makefile fix(install_offline): Fix install_offline recipe to run in install fo… Aug 29, 2018
Makefile.conf fix(cliTest): Ununpack and copyright cli test fixes May 7, 2018
Makefile.deps fix(cliTest): Ununpack and copyright cli test fixes May 7, 2018
Makefile.process Removed SVN_REV from files and replaced Commit with commit_hash Dec 3, 2015
NOTICES docs(notes): updating documentation for new release Feb 7, 2018
NOTICES.spdx docs(notes): updating documentation for new release Feb 7, 2018
README.md docs(README): fix readme for docker-compose and version numbers Aug 17, 2018
Vagrantfile chore(vagrant): Switched to ubuntu/xenial64. Sep 19, 2018
docker-compose.yml fix(postgresql): Fixed postgresql version to 9.6 and use a volume for… Oct 30, 2018
docker-entrypoint.sh feat(docker): Replaced standalone Dockerfile with docker-compose. Aug 17, 2018
fossology_doxygen.conf feat(copyright): Use package based dependency for json Oct 31, 2018

README.md

FOSSology

Travis-CI Build Status Stories in Ready Coverage Status

About

FOSSology is a open source license compliance software system and toolkit. As a toolkit you can run license, copyright and export control scans from the command line. As a system, a database and web ui are provided to give you a compliance workflow. In one click you can generate an SPDX file, or a ReadMe with all the copyrights notices from your software. FOSSology deduplication means that you can scan an entire distro, rescan a new version, and only the changed files will get rescanned. This is a big time saver for large projects.

Check out Who Uses FOSSology!

FOSSology does not give legal advice. http://fossology.org/

Requirements

The PHP versions 5.6.x and 7.0.x are supported to work for FOSSology. FOSSology requires Postgresql as database server and apache httpd 2.6 as web server. These and more dependencies are installed by utils/fo-installdeps.

Installation

FOSSology should work with many Linux distributions.

See https://github.com/fossology/fossology/releases for source code download of the releases.

For installation instructions see Github Wiki

Docker

FOSSology comes with a Dockerfile allowing the containerized execution both as single instance or in combination with an external PostgreSQL database. Note: It is strongly recommended to use an external database for production use, since the the standalone image does not take care of data persistency.

A pre-built Docker image is available from Docker Hub and can be run using following command:

docker run -p 8081:80 fossology/fossology

The docker image can then be used using http://IP_OF_DOCKER_HOST:8081/repo user fossy passwd fossy.

Execution with external database container can be done using Docker Compose, via the following command:

docker-compose up

The Docker image allows configuration of it's database connection over a set of environment variables.

  • FOSSOLOGY_DB_HOST: Hostname of the PostgreSQL database server. An integrated PostgreSQL instance is used if not defined or set to localhost.
  • FOSSOLOGY_DB_NAME: Name of the PostgreSQL database. Defaults to fossology.
  • FOSSOLOGY_DB_USER: User to be used for PostgreSQL connection. Defaults to fossy.
  • FOSSOLOGY_DB_PASSWORD: Password to be used for PostgreSQL connection. Defaults to fossy.

Vagrant

FOSSology comes with a VagrantFile that can be used to create an isolated environment for FOSSology and its dependencies.

Pre-requisites: Vagrant >= 2.x and Virtualbox >= 5.2.x

Steps:

git clone https://github.com/fossology/fossology
cd fossology/
vagrant up

The server must be ready at http://localhost:8081/repo/ and user can login the credentials using

user: fossy
pass: fossy

Documentation

We are currently migrating our documentation to github. At this stage you can find general documentation at: http://www.fossology.org/projects/fossology/wiki/User_Documentation and developer docs here on github

Support

Mailing lists, FAQs, Release Notes, and other useful info is available by clicking the documentation tab on the project website. We encourage all users to join the mailing list and participate in discussions. There is also a #fossology IRC channel on the freenode IRC network if you'd like to talk to other FOSSology users and developers. See Contact Us

Contributing

We really like contributions in several forms, see CONTRIBUTING.md

Licensing

The original FOSSology source code and associated documentation including these web pages are Copyright (C) 2007-2012 HP Development Company, L.P. In the past years, other contributors added source code and documentation to the project, see the NOTICES file or the referring files for more information.

Any modifications or additions to source code or documentation contributed to the FOSSology project are Copyright (C) the contributor, and should be noted as such in the comments section of the modified file(s).

FOSSology is licensed under GPL-2.0

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 of the License

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Exception:

All of the FOSSology source code is licensed under the terms of the GNU General Public License version 2, with the following exceptions:

libfossdb and libfossrepo libraries are licensed under the terms of the GNU Lesser General Public License version 2.1, LGPL-2.1.

This library are free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301  USA

Please see the files COPYING and COPYING.LGPL included with this software for the full text of these licenses.