ssham: Secure Shell Access Manager
GitHub Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Laravel Sail

Laravel Sail is a light-weight command-line interface for interacting with Laravel’s default Docker development environment. This will create several containers to implement all SSHAM needs. An application server and a database server.

Prior to this installation, you need to have installed this software:

  1. Clone the repository locally

    git clone https://github.com/pacoorozco/ssham.git ssham
    cd ssham
    
  2. Copy .env.example to .env.

    NOTE: You don’t need to touch anything from this file. It works with default settings.

  3. Install PHP dependencies with:

    NOTE: You don’t need to install neither PHP nor Composer, we are going to use a Composer image instead.

    docker run --rm \                  
    -u "$(id -u):$(id -g)" \
    -v $(pwd):/var/www/html \
    -w /var/www/html \
    laravelsail/php82-composer:latest \
    composer install --ignore-platform-reqs
    
  4. Start all containers with the sail command.

    ./vendor/bin/sail up -d
    
  5. Seed database in order to play with some data

    # Running Artisan commands within Laravel Sail...
    sail artisan key:generate 
    sail artisan migrate:fresh --seed
    
  6. Point your browser to http://localhost and test SSH Access Manager. Enjoy!

    NOTE: Default credentials are here.