Skip to content

Latest commit

 

History

History
 
 

docker

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
kubernetes/kustomize
kubernetes/kustomize
 
 
local
local
 
 
.env.example
.env.example
 
 
Readme.md
Readme.md
 
 

Readme.md

Docker is the easiest way to get started with self-hosted Novu, however if you want to set up the system on docker for local development look here or if you want to deploy Novu to Kubernetes check here

Before you begin

You need the following installed in your system:

Quick Start

Get the code

Clone the Novu repo and enter the docker directory locally:

# Get the code
git clone https://github.com/novuhq/novu

# Go to the docker folder
cd novu/docker

# Copy the example env file
cp .env.example ./local/deployment/.env

# Start Novu
docker-compose -f ./local/deployment/docker-compose.yml up

Now visit http://localhost:4200 to start using Novu.

Securing your setup

While we provide you with some example secrets for getting started, you should NEVER deploy your Novu setup using the defaults provided.

Update Secrets

Update the .env file with your own secrets. In particular, these are required:

  • JWT_SECRET: used by the API to generate JWT keys

Redis config

Redis TLS can be configured by adding the following variables to the .env file and specifying the necessary properties inside:

  • REDIS_TLS={"servername":"localhost"}
  • REDIS_CACHE_SERVICE_TLS={"servername":"localhost"}

Configuration

To keep the setup simple, we made some choices that may not be optimal for production:

  • the database is in the same machine as the servers
  • the storage uses the filesystem backend instead of S3

We strongly recommend that you decouple your database before deploying.

Next steps