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. provider
        5. oauth providers
        6. oauth providers
      3. 2.3.3Step 3 Insert administator
      4. 2.3.4Step 4 Confirm
  3. 3Use Lavagna
    1. 3.1Project
      1. 3.1.1Create Project
      2. 3.1.2Project settings
      3. 3.1.3Edit Project
      4. 3.1.4Archive Project
      5. 3.1.5Delete Project
    2. 3.2Board
      1. 3.2.1Create Board
      2. 3.2.2Edit Board
      3. 3.2.3Archive Board
      4. 3.2.4Delete Board
    3. 3.3Columns
      1. 3.3.1Create a new column
      2. 3.3.2Special columns
        1. the backlog
        2. the archive
        3. the trash
      3. 3.3.3Change the name of a column
      4. 3.3.4Column menu
      5. 3.3.5Change status color
    4. 3.4Card
      1. 3.4.1Create a new card
      2. 3.4.2Access the card menu in a board
      3. 3.4.3Work with a card
        1. the card title
        2. the card description
        3. a label
        4. the card
        5. the card due date
        6. the card to a milestone
        7. with people
          1. the card to a user
          2. operations
        8. with action lists
    5. 3.5Labels
      1. 3.5.1Use labels
      2. 3.5.2Manage labels
        1. a label
        2. a label
        3. a label
    6. 3.6Milestones
      1. 3.6.1Use milestones
        1. a milestone
      2. 3.6.2Manage milestones
        1. a new milestone
        2. a milestone
    7. 3.7Search
      1. 3.7.1Filters
        8. by
        12. text search
      2. 3.7.2Single board search
      3. 3.7.3Global and project specific search
    8. 3.8Operations on multiple cards
      1. 3.8.1Select cards
      2. 3.8.2Operations
    9. 3.9Calendars
    10. 3.10Project Statistics
      1. 3.10.1Filtering
      2. 3.10.2Basic statistics
      3. 3.10.3Chart statistics
    11. 3.11Import data from external sources
      1. 3.11.1Trello
        2. data
    12. 3.12Create tickets via E-mail
      1. 3.12.1Manage ticket E-mail configuration
        1. mail configuration
        2. ticket configuration
        3. configurations
        4. configuration
        5. configuration
      2. 3.12.2Support localized E-Mail notifications
    13. 3.13Manage profile
      1. 3.13.1Profile
      2. 3.13.2Calendar access
      3. 3.13.3Change password
  4. 4Administration
    1. 4.1Configuration parameters
    2. 4.2Login
      1. 4.2.1Anonymous user access
      2. 4.2.2Login providers
        2. (internal provider)
        5. oauth providers
        6. oauth providers
    3. 4.3Users
      1. 4.3.1Add User
      2. 4.3.2Import users from a file
      3. 4.3.3User actions
    4. 4.4Access control
      1. 4.4.1Global and Project Roles
        1. roles
        2. roles for effective access control
      2. 4.4.2Permissions
      3. 4.4.3Manage roles
        1. a new role
        2. a role
        3. a role
        4. project role
    5. 4.5Mail notifications
    6. 4.6Import/Export data
      1. 4.6.1Exporting
      2. 4.6.2Importing
    7. 4.7External integrations
      1. 4.7.1Script creation
        1. events
      2. 4.7.2Script example
      3. 4.7.3Manage the integration


2.3.1Step 1, Base url or import

After successfully launching the application, go to http://your-lavagna-install/setup .

The following page will be shown:

First setup step

  • If it’s a new install, confirm that the base url is correct and click Next
  • If it’s an import, select the exported file and click Import. The import process can take a noticeable amount of time.

2.3.2Step 2, Login provider configuration

Lavagna does not store the user credentials by design: an external provider must be chosen. There are 3 possible choice:

  • password
  • demo (use for test purpose only)
  • ldap
  • oauth provider

If you want to manage your accounts inside lavagna.

Password provider provider

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 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 “Check ldap configuration” form. provider

The application support the following external oauth providers:

  • bitbucket
  • github
  • google
  • twitter

Additionally, self-hosted/others external gitlab instances can be configured in the Custom Oauth provider section.

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

If you have a self-hosted (or others) gitlab instance, you can configure in the “Custom oauth providers” section.
Select the type, enter the name, the base url, api key and api secret.

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.

2.3.3Step 3 Insert administator

In the third step, the administrator must be defined. Enter the username and click Next.

Insert admin user

2.3.4Step 4 Confirm

Check the validity of the configuration data. Click on Activate: the configuration will be saved and the browser will go to the root of the application. Enter the username (and password if required).