Manual

1. Clone the repository locally

   git clone https://codeberg.org/pakus/ssham.git ssham
   cd ssham
   

2. Install PHP dependencies with composer

   curl -s https://getcomposer.org/installer | php
   php composer.phar install
   

3. Copy .env.example to .env.

4. Modify the content of the .env file to put your settings, something like that:

   DB_HOST='Your database host'
   DB_DATABASE='Your database name'
   DB_USERNAME='Your database user'
   DB_PASSWORD='Your database password'
   

5. Seed database in order to play with some data

   php artisan key:generate 
   php artisan migrate:fresh --seed
   

6. Build CSS/JS assets

   npm install 
   npm run build
   

7. Make sure storage/ and bootstrap/cache/ folders are writable by your web server. You can do it this way:

   chmod -R 777 storage/ bootstrap/cache/
   

8. Configure crontab to run scheduled tasks (eg. cleaning audit logs)

   crontab -e 
   

   Add this line to execute the scheduler:

   * * * * * cd /path/to/ssham && php artisan schedule:run >> /dev/null 2>&1
   

9. You can use the local PHP server to run the application.

   php artisan serve --port=4000`
   

10. Your SSH Access Manager is now listening at http://localhost:4000. Enjoy!

NOTE: Default credentials are here.