Skip to content

Latest commit

 

History

History
60 lines (43 loc) · 2.22 KB

CUSTOMIZATION.md

File metadata and controls

60 lines (43 loc) · 2.22 KB

How to customize MISP image

You can create your custom MISP image based on NUKIB image, which can include your customizations.

Additional environment variables for visual changes

  • MISP_CUSTOM_CSS (optional, string) - filename from /var/www/MISP/app/webroot/css/ directory that will be used as another CSS file
  • MISP_TERMS_FILE (optional, string) - filename from /var/www/MISP/app/files/terms/ directory
  • MISP_HOME_LOGO (optional, string) - filename from /var/www/MISP/app/files/img/custom/ directory that will be used as home logo
  • MISP_FOOTER_LOGO (optional, string) - filename from /var/www/MISP/app/files/img/custom/ directory that will be used as footer logo

Add custom certificates

This image uses by default system certificates for TLS. If you use custom certificate authority that is not trusted in base image, just copy that certificate in PEM format to /etc/pki/ca-trust/source/anchors/ directory and run update-ca-trust command.

Add images

You can add additional custom org or custom images by copying them to /customize/img_orgs/ or to /customize/img_custom/ directories during container build.

Example

Create a new file Dockerfile in a new directory and copy your customization files:

# Base on original NUKIB image
FROM ghcr.io/nukib/misp

# Include custom CA to system certificates
COPY cert.pem /etc/pki/ca-trust/source/anchors/
RUN update-ca-trust

# Copy additional organization logos
COPY org-images/* /customize/img_orgs/
# Copy custom images, that can be used as home or footer logo
COPY img/* /customize/img_custom/
# Copy custom CSS
COPY custom.css /var/www/MISP/app/webroot/css/
# Copy custom terms
COPY terms.html /var/www/MISP/app/files/terms/

ENV MISP_CUSTOM_CSS custom.css
ENV MISP_HOME_LOGO misp.svg
ENV MISP_FOOTER_LOGO footer.svg
ENV MISP_TERMS_FILE terms.html

Then to create a custom image, call this command in the directory that contains created Dockerfile.

docker build -t misp-custom .

After the build, you can use your custom image by changing the image definition for MISP container in docker-compose.yml or by running the command in the directory that contains docker-compose.yml file.

MISP_IMAGE=misp-custom docker compose up -d