If you’re looking for a simple solution to track issues and projects efficiently, then Lavagna could be your perfect companion. It’s small, user-friendly, and built on Java 8 or better, allowing it to stand strong alongside databases like MySQL, MariaDB, and PostgreSQL. Let’s walk through a step-by-step guide on how to install and run this exceptional software.

What is Lavagna?

Lavagna is a lightweight issue/project tracking software. It’s designed to streamline your workflow with easy deployment options as either a simple war file or as a self-contained war file that includes an embedded Jetty web server.

Installation Steps

• Ensure your environment meets the following requirements:
  • Java 8 or better
  • Database: MySQL (5.1 or later), MariaDB (10.1), PostgreSQL (9.1), or HSQLDB
• Choose your preferred deployment method:
  • Standalone WAR for your web container
  • Self-contained WAR with embedded Jetty
• Follow the documentation available at help.lavagna.io for setup specifics.

Testing Locally

To test Lavagna locally, execute the following commands:

wget https://repo1.maven.org/maven2/io/lavagna/lavagna/1.1.9/lavagna-1.1.9-distribution.zip
unzip lavagna-1.1.9-distribution.zip
cd lavagna-1.1.9/bin
./lavagna.sh

Now, head to http://localhost:8080 and log in with the username and password both set to “user”.

Understanding Lavagna: An Analogy

Imagine Lavagna as a busy café where orders (tasks or issues) are placed at the counter (your tracking software). To ensure every order gets attended to without confusion, you have a dedicated area (the self-contained WAR or web container) where orders are processed efficiently, handled either by a skilled waiter (your Java environment) or a group of friendly chefs (the databases) ready to whip up delicious meals (solutions). This setup allows the café to run smoothly, ensuring every customer leaves satisfied!

How to Launch the Web Server

Once your setup is complete, launch the web server using:

mvn jetty:run

For specific database management, use the following options:

• HSQLDB: mvn jetty:run -DstartDBManager
• MySQL: mvn jetty:run -Pdev-mysql
• PostgreSQL: mvn jetty:run -Pdev-pgsql

Visit http://localhost:8080 for access, and if you encounter a 403 error, configure your application settings accordingly.

Troubleshooting

In case you run into issues while setting up or running Lavagna, here are some troubleshooting ideas:

• Ensure Java is properly installed and that your version is compatible with Lavagna requirements.
• Check your database connection and configurations to ensure they are correctly set up.
• Review the logs for any error messages that could give clues on what went wrong.
• If issues persist, feel free to reach out for help or stay updated with the latest documentation.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

About Database Support

Remember that when using MySQL, you need to create your database with UTF-8 collation by executing:

CREATE DATABASE lavagna CHARACTER SET utf8 COLLATE utf8_bin;

Conclusion

By following these steps, you should be well on your way to leveraging Lavagna for efficient project tracking. Whether for personal use or team collaboration, Lavagna promises simplicity and effectiveness!

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.