Install guide for us novice users

[twillett]

Tried installing on Ubuntu 22.04 by copy/paste the code posted on the main page and hit nothing but issues. Anyone have a better install and setup guide for us not so smart users?

[robertocannella]

Hi, I'm attempting to install this on AWS and having similar issues. I think one issue may be PHP8.1. What version of PHP are you using in your configuration?

Curiously, composer.json reflects support for anything greater that 7.4, but I'm getting a ton of null reference errors in the templates with 8.1. Albeit, I'm new to laravel in general, so there may be other reasons for it.

I do feel more thorough installation documentation would be helpful (and would gladly offer up some my technical writing skills)
-r

[Sebbito]

Maybe i can explain some for the Ubuntu 22.04 case. Not so much for the AWS case.

I'm guessing that the main problem for you @twillett came from not knowing what to do with the info from the first comment in the example install step:

# Setup your .env file to match your desired database

This is also not a clear explanation for people who don't know a lot about how laravel works so imma explain what that means.

Basically Handesk requires you to:
A. Have a Database in place (so something like MariaDB, MySQL or anything else)
B. Have set up your .env file accordingly

Let's first go over B.

For any Laravel application you need a .env file that holds various information. It's best to copy the .env.example file given and modify the necessary information.

First copy the file:
cp .env.example .env

Now you can see near the top of the file some database information:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=handesk
DB_USERNAME=handesk
DB_PASSWORD=password

(Note: you probably have different values for DB_DATABASE and DB_USERNAME, i already adjusted them)

Here you can change the database-/username and password to anything you'd like. I'd suggest you use handesk for database and username to make it clear what the database and user are for. The password you can fill in yourself.

Now for part A, the database stuff.

You have to create the same user with the password you set in your .env file in your database. In the mysql case do the following:

1. Connect to the database (assuming it runs on the same machine as handesk): mysql -u root -p
2. Create the database with the name you chose: CREATE DATABASE handesk;
3. Create the user with password: CREATE USER 'handesk'@'localhost' IDENTIFIED BY 'password';
4. Grant permissions: GRANT ALL PRIVILEGES on handesk.* to 'handesk'@'localhost';

Then when you execute the installation steps from the README it should work.

Do note that i am not sure what your exact problem was since but I'm guessing that this is what most people will fail at when not knowing about Laravel.

[vagkaefer]

Guys, it is a project made with the Laravel framework, if you know the basics of installing Laravel you will know how to install this system, I suggest you take a look at Laravel, this will also help you to carry out future modifications and customizations.