Concerto (Fresh)

Concerto (fresh) is an experiment in radically simplifying Concerto 2 to enable long-term support and easy maintance.

Installation

There are two ways to install Concerto: using Docker (recommended) or from the Git repository.

Option 1: Docker (Recommended)

The easiest way to get Concerto running is with Docker.

Steps

docker pull ghcr.io/bamnet/concerto:latest

# If you need to generate a secret
docker run --rm ghcr.io/bamnet/concerto:latest bin/rails secret

docker run -d \
     -p 80:80 \
     -e SECRET_KEY_BASE=<your-generated-secret> \
     -v concerto_storage:/rails/storage \
     --name concerto \
     ghcr.io/bamnet/concerto:latest

Open your browser and navigate to http://localhost.

Configuration Options

Environment Variable	Description	Default
SECRET_KEY_BASE	Secret key for encrypting sessions (required)	-
RAILS_MAX_THREADS	Maximum number of threads	5
DISABLE_SSL	Set this to allow non-SSL access	-

Development

To start a local development server:

bin/dev

Misc Notes:

• We use ImportMaps to manage JS deps. Add dependencies using a command like bin/importmap pin @stimulus-components/dropdown
• Needs icons? Copy and paste SVG from https://heroicons.com/.

Testing

Unit tests:

bin/rails test

System tests:

bin/rails test:system

Frontend tests:

yarn run vitest