# freeacs

**Repository Path**: Win.Feng/freeacs

## Basic Information

- **Project Name**: freeacs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-12-21
- **Last Updated**: 2024-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Free ACS

![Freeacs Logo](https://github.com/freeacs/readme/blob/master/logo.png)
 
![main](https://github.com/freeacs/freeacs/actions/workflows/maven.yml/badge.svg?branch=master)
[![Maintainability](https://api.codeclimate.com/v1/badges/4b32968512c546806799/maintainability)](https://codeclimate.com/github/freeacs/freeacs/maintainability)
[![CodeQL Analysis](https://github.com/freeacs/freeacs/actions/workflows/codeql.yml/badge.svg)](https://github.com/freeacs/freeacs/actions/workflows/codeql.yml)

FreeACS is a somewhat complete TR-069 ACS available for free under the MIT License. You can download and install it, or contribute to the project! 

## Prerequisites

FreeACS requires Java 17 and MySQL. It has been tested to work on Java 17, 18 and 19 and latest version of MySQL (the latter with some minor quirk in the install script).

## Discussion

* Discussion: https://github.com/freeacs/freeacs/discussions
* [Freeforums] (deprecated)

## Build it

FreeACS is built with SBT on unix/linux systems:

```bash
$ ./mvnw test
```

Packaged to deployable zips with:

```bash
$ ./mvnw package
```

See the distribution modules target folder or the individual module target folders for deployable zip files.

## Contributing

Please read [CONTRIBUTING.md](https://github.com/freeacs/freeacs/blob/master/CONTRIBUTING.md) for instructions to set up your development environment to build FreeACS

## Versioning

We use SemVer for versioning.

## License

This project is licensed under the The MIT License.

## Active project Members

* **Jarl André Hübenthal (@jarlah)**

See https://github.com/freeacs/freeacs/wiki/About for information.