Lavagna HELP
  1. 1About
  2. 2Install
    1. 2.1Database
      1. 2.1.1MySql
      2. 2.1.2MariaDB
      3. 2.1.3PostgreSQL
      4. 2.1.4HSQLDB
    2. 2.2Configuration
      1. 2.2.1Self contained
      2. 2.2.2Servlet container
    3. 2.3Setup
      1. 2.3.1Step 1, Base url or import
      2. 2.3.2Step 2, Login provider configuration
        1. provider
        2. provider
        3. provider
        4. oauth providers
        5. oauth providers
      3. 2.3.3Step 3 Insert administator
      4. 2.3.4Step 4 Confirm
  3. 3Configuration and Administration
    1. 3.1Configuration parameters
    2. 3.2Login
      1. 3.2.1Anonymous user access
      2. 3.2.2Login providers
        4. oauth providers
        5. oauth providers
    3. 3.3SMTP configuration
    4. 3.4Users
      1. 3.4.1Create a user
      2. 3.4.2Import users from a file
    5. 3.5Roles and permissions
      1. 3.5.1Roles
      2. 3.5.2Permissions
    6. 3.6Import/Export data
      1. 3.6.1Exporting
      2. 3.6.2Importing
  4. 4User Manual
    1. 4.1Get Started
    2. 4.2Project
      1. 4.2.1Create a project
      2. 4.2.2Create a board
      3. 4.2.3Project statistics
      4. 4.2.4Project milestones
    3. 4.3Board
      1. 4.3.1Columns
        1. a new column
        2. the name of a column
        3. menu
      2. 4.3.2Archive, Backlog, and Trash
      3. 4.3.3Card menu
      4. 4.3.4Interact with the board
      5. 4.3.5Bulk operations
      6. 4.3.6Create a Card
    4. 4.4Card
      1. 4.4.1Card
        1. and manage a single card
        2. header
        3. column
        4. action panel
        8. column
        10. Tab
        11. Tab
        12. Tab
        13. column
        15. lists
      2. 4.4.2Comments
        1. a new comment
        2. to a single comment
        3. a comment
        4. a comment
      3. 4.4.3Files
        1. files
        2. files
      4. 4.4.4Manage lists
        1. a new action list
        2. and sort
    5. 4.5User
      1. 4.5.1User page
      2. 4.5.2Change user settings
    6. 4.6Search
      1. 4.6.1Filters
        8. by
        12. text search
      2. 4.6.2Single board search
      3. 4.6.3Global and project specific search
    7. 4.7Project Administration
      1. 4.7.1Project and boards settings
      2. 4.7.2Manage milestones
      3. 4.7.3Manage Access
      4. 4.7.4Manage labels
          1. List
      5. 4.7.5Customize status color
      6. 4.7.6How to import your data from Trello


The login section provide the configuration space for:

  • anonymous user access
  • login providers

3.2.1Anonymous user access

By default, the access for anonymous user is disabled. It can be enabled by clicking on the toggle at the right (see screenshot below):

Anonymous user access configuration section

As a standard behaviour, the anonymous user don’t have access to any project. The access can be enabled globally, by toggling the “Global Access” option or by enabling it in a per project basis in the project configuration section.

Additionally, the search functionality can be enabled for the anonymous users by toggling the “Enable Search” entry.

3.2.2Login providers

Lavagna support multiple providers at the same time. In this section they can be enabled and configured.

The demo provider must not be selected in production, as the password is the username. It can be useful for a small test round for evaluating the product.

Demo provider

If the users are stored in a ldap directory (Active Directory is supported too), the ldap provider must be configured.

Ldap provider

It requires a user that can query the directory (the Manager DN and Manager Password).

The query is composed by a base (Search base) and the filter (User search filter), where {0} is the placeholder for the username.

The configuration can be tested in the “Verify” form.

The application support the following external oauth providers:

Additionally, self-hosted gitlab instances can be configured with the “Add new provider” functionality.

Oauth provider oauth providers

Select the oauth provider of the first account and provide the api key and secret. The provided callback url should be the correct one that must be provided.

See the documentation for: oauth providers

In the case of self-hosted oauth providers (currently only gitlab is supported), they can be configured by clicking the “Add new provider” button.

Please note that if you are using self signed certificates you must include them in the default keystore of your java virtual machine. See the keytool documentation and this stackoverflow post. Lavagna will not provide a way to ignore untrusted certificates.

It will open the following modal window:

Add new configurable Oauth provider modal window

Select the type (currently only gitlab is available) and insert the name, the base url, the api key and secret. Copy the provided callback url in your oauth provider configuration screen. Save the provider by clicking the “Add new provider” button.

The new providers will appear in the section “Configurable OAuth providers”, it can be :

  • updated by changing the values and clicking the “Save” button
  • deleted by clicking on the toggle and clicking the “Save” button