fleet/ee/bulk-operations-dashboard
Scott Gress 379156e578
Use new exclude_fleet_maintained_apps flag (#25674)
for #25427 

This PR updates the calls to the "list software titles" API to include
the `exclude_fleet_maintained_apps=true` flag.

I tested this with https://github.com/fleetdm/fleet/pull/25649
successfully.
2025-01-30 11:25:33 -06:00
..
api Use new exclude_fleet_maintained_apps flag (#25674) 2025-01-30 11:25:33 -06:00
assets MSP Dashboard: Add labels to profiles page (#23145) 2024-12-05 17:39:47 -06:00
config MSP Dashboard: Add Entra SSO Hook (#24740) 2025-01-03 10:14:13 -06:00
scripts Bulk operations dashboard: Add software page (#22584) 2024-10-15 10:17:05 -05:00
tasks Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
views MSP Dashboard: Add Entra SSO Hook (#24740) 2025-01-03 10:14:13 -06:00
.editorconfig Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
.eslintignore Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
.eslintrc Bulk operations dashboard: Add software page (#22584) 2024-10-15 10:17:05 -05:00
.gitignore Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
.htmlhintrc Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
.lesshintrc Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
.npmrc Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
.sailsrc Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
app.js Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
docker-compose.yaml MSP dashboard: Update readme to document all required config values (#24773) 2024-12-13 17:24:52 -06:00
Dockerfile Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
entrypoint.sh MSP Dashboard: update entrypoint script. (#24911) 2024-12-19 10:52:31 -06:00
Gruntfile.js Add app to manage scripts and profiles. (#21450) 2024-08-22 14:59:15 -06:00
package.json MSP Dashboard: Add Entra SSO Hook (#24740) 2025-01-03 10:14:13 -06:00
README.md MSP dashboard: Update readme to document all required config values (#24773) 2024-12-13 17:24:52 -06:00

Bulk operations dashboard

A dashboard to easily manage profiles and scripts across multiple teams on a Fleet instance.

Dependencies

  • A datastore, this app was built using Postgres, but you can use a database of your choice.

  • A Redis database - For session storage.

Configuration

This app has two required custom configuration values:

  • sails.config.custom.fleetBaseUrl: The full URL of your Fleet instance. (e.g., https://fleet.example.com)
  • sails.config.custom.fleetApiToken: An API token for an API-only user on your Fleet instance.

Required configuration for software features

If you are using this app to manage software across multiple teams on a Fleet instance, five additional configuration values are required:

  • sails.config.uploads.bucket The name of an AWS s3 bucket where unassigned software installers will be stored.
  • sails.config.uploads.secret The secret for the S3 bucket where unassigned software installers will be stored.
  • sails.config.uploads.region The region the AWS S3 bucket is located.
  • sails.config.uploads.bucketWithPostfix: The name of the s3 bucket with the directory that the software installers are stored in on appended to it. If the files will be stored in the root directory of the bucket, this value should be identical to the sails.config.uploads.bucket value
  • sails.config.uploads.prefixForFileDeletion: The directory path in the S3 bucket where the software installers will be stored. If the installers will be stored in the root directory, then this value can be set to ' '.

Running the bulk operations dashboard with Docker.

To run a local bulk operations dashboard with docker, you can follow these instructions.

  1. Clone this repo

  2. Update the following ENV variables ee/bulk-operations-dashboard/docker-compose.yml file:

  3. sails_custom__fleetBaseUrl: The full URL of your Fleet instance. (e.g., https://fleet.example.com)

  4. sails_custom__fleetApiToken: An API token for an API-only user on your Fleet instance.

You can read about how to create an API-only user and get it's token here

  1. Open the ee/bulk-operations-dashboard/ folder in your terminal.

  2. Run docker compose up --build to build the bulk operations dashboard's Docker image.

The first time the bulk operations dashboard starts it will Initalize the database aby running the config/bootstrap.js script before the server starts.

  1. Once the container is done building, the bulk operations dashboard will be available at http://localhost:1337

You can login with the default admin login:

  • Email address: admin@example.com

  • Password: abc123