Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/boldreports/bold-reports-docker

Docker configuration and user guide for Bold Reports deployment.
https://github.com/boldreports/bold-reports-docker

bold-reports centos docker embedded report-builder report-designer report-server report-viewer reporting-tools ssrs-reports syncfusion ubuntu user-management

Last synced: 1 day ago
JSON representation

Docker configuration and user guide for Bold Reports deployment.

Awesome Lists containing this project

README

        

boldreports



[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/boldreports/bold-reports-docker?sort=semver)](https://github.com/boldreports/bold-reports-docker/releases)
[![Documentation](https://img.shields.io/badge/docs-help.boldreports.com-blue.svg)](https://help.boldreports.com/enterprise-reporting/)
[![File Issues](https://img.shields.io/badge/file_issues-boldreports_support-blue.svg)](https://www.boldreports.com/support)

# What is Bold Reports

Bold Reports Enterprise Reporting is a business intelligence report management tool, built by Syncfusion for creating, managing, and distributing pixel-perfect paginated RDL reports behind your organization’s firewall.

Enterprise Reporting help us to analyse, explain and report business information in our day-to-day life.

## Deployment Prerequisites

### Hardware requirements

The following hardware requirements are necessary to run the Bold Reports solution:

* Operating System: You can use the Bold Reports Docker and Podman on the following operating systems:
* Windows
* Ubuntu 20.04 LTS
* Cent OS 7
* Mac
* Red Hat Enterprise Linux (RHEL)
* Alpine Linux
* CPU: 4-core.
* Memory: 16 GB RAM.
* Disk Space: 8 GB or more.

### Software requirements

The following software requirements are necessary to run the Bold Reports Enterprise edition:

* Database: Microsoft SQL Server 2012+ | PostgreSQL | MySQL
* Application: Docker, Podman
* Web Browser: Microsoft Edge, Mozilla Firefox, and Chrome

# Supported tags

| Tags | OS Version | Last Modified |
| ------------- | ------------- | ------------- |
| `6.2.32` | Ubuntu 20.04 (amd64) | 08/13/2024 |
| `6.2.32_alpine` | Alpine 3.13 (amd64) | 08/13/2024 |
| `6.2.32_debian` | Debian 10 (amd64,arm64) | 08/13/2024 |
|`6.2.32_arm64`|Debian 10 (arm64)|08/13/2024 |
|`6.2.32_ubuntu_arm64`| Ubuntu 20.04 (arm64) | 08/13/2024 |

Note: The tag `6.2.32_ubuntu_arm64` have some limitations where the data visualization will not be work in the exported reports.

# How to use this image

The above Bold Reports image can be deployed using Docker or Docker Compose. In the following section, we are going to start the Bold Reports application and a separate PostgreSQL instance with volume mounts for data persistence using Docker Compose.

1. Download the Docker Compose file by using the following command.
```sh
curl -o docker-compose.yml "https://raw.githubusercontent.com/boldreports/bold-reports-docker/master/deploy/single-container-pre-configured/docker-compose.yml"
```
2. Open the Docker Compose file, uncomment the APP_URL and replace with your DNS or IP address with port number, by which you want to access the application.

For example,
`http://example.com `
`https://example.com`
`http://`
`http://host.docker.internal`

![docker-single-pre-conf](docs/images/single-container-pre-app-url.png)

3. Fill the BOLD_SERVICES_UNLOCK_KEY value, and save it. You can refer to [this](https://support.boldreports.com/kb/article/13271/how-do-i-get-my-offline-license-key-from-our-bold-reports-account-page) KB document to obtain the offline Bold Reports unlock key.

![docker-compose-variable](docs/images/docker-compose-variable.png)

4. Fill the Environment Variables and optional library by refer [this](docs/environment-variable.md).

5. Run the command below. This command will start the Bold Reports and Postgres SQL containers and display the Bold Reports logs to provide information about the installation status of the Bold Reports application.
```sh
docker-compose up -d; docker-compose logs -f boldreports
```
![docker-compose-up](docs/images/docker-compose-up.png)

6. Now, access the Bold Reports application by entering the URL as `http://host.docker.internal` or `http://host-ip` in the browser. When opening this URL in the browser, it will configure the application startup in the background and display the page below within a few seconds. The default port number mentioned in the compose file is 80. If you are making changes to the port number, then you need to use that port number for accessing the Bold Reports application.

![docker-startup](docs/images/docker-startup.png)

# How to Deploy Bold Reports using Advanced Configuration?

In this section, you will learn how to run the Bold Reports application using advanced configurations such as configuring Bold Reports using an existing DB server, using a host directory as a persistent volume, configuring startup manually, configuring an SSL certificate, and running a multi-container Reports application.

1. [How to deploy Bold Reports using existing DB server?](./docs/how-to-deploy-bold-reports-using-existing-db-server.md)
2. [How to deploy Bold Reports and configure startup manually?](./docs/how-to-deploy-bold-reports-and-configure-startup-manually.md)
3. [How to use host path as Persistent Volume?](./docs/how-to-use-host-path-as-persistent-volume-for-bold-reports-deployment.md)
4. [How to configure SSL for Bold Reports application? ](./docs/FAQ/how-to-configure-ssl-for-docker-compose.md)
5. [How to start multiple containers Bold Reports with Docker Compose?](./docs/multiple-container.md)
6. [How to start multiple containers podman Bold Reports with Docker Compose?](./docs/multiple-container-podman.md)
7. [Bold Reports supported environment variables and their usage?](./docs/environment-variable.md)

# License

https://www.boldreports.com/terms-of-use/on-premise

The images are provided for your convenience and may contain other software that is licensed differently (Linux system, Bash, etc. from the base distribution, along with any direct or indirect dependencies of the Bold Reports platform).

These pre-built images are provided for your convenience and include all optional and additional libraries by default. These libraries may be subject to different licenses than the Bold Reports product.

If you want to install Bold Reports from scratch and precisely control which optional libraries are installed, please download the stand-alone product from boldreports.com. If you have any questions, please contact the Bold Reports team (https://www.boldreports.com/support).

It is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.

# FAQ

[How to configure SSL for Bold Reports Application in single container and multiple container?](https://github.com/boldreports/bold-reports-docker/blob/master/docs/FAQ/how-to-configure-ssl-for-docker-compose.md)

[How to reset the database for Bold Reports application in docker environment?](./docs/FAQ/how-to-reset-the-database-in-docker.md)

[How to auto deploy multiple services Bold Reports via docker-compose?](./docs/FAQ/how-to-auto-deploy-bold-reports-multiple-services-in-docker-compose.md)

[How to upgrade a new image in docker environment using docker compose yaml file?](./docs/upgrade.md)

[How to deploy Bold Reports on an ECS Fargate cluster using an Application Load Balancer](https://support.boldreports.com/kb/article/14105/deploy-bold-reports-on-an-ecs-fargate-cluster-using-an-application-load-balancer)