# Installation

# Prerequisites

Before you start, you need to install the prerequisites.

• Laravel 5.8 Server Requirements
• Laravel Echo Server
• Composer
• ImageMagick PHP Extension
• MySQL or PostgreSQL (with JSON support)
• Redis

# Clone the Repository

We recommend that you use the latest stable version.

$ git clone [email protected]:galaxyofdrones/galaxyofdrones.git
$ cd galaxyofdrones
$ git tag -l

v1.0.0
v1.0.0-alpha1
v1.0.0-alpha2
v1.0.0-beta1
v1.0.0-beta2
v1.0.1

$ git checkout v1.0.1

# Copy the Configuration

By default Galaxy of Drones Online comes with an example configuration file.

$ cp .env.example .env

# Configuring a Database

You can edit these values in the newly created .env file.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

# Configuring the Redis

You can edit these values in the .env file.

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
REDIS_DB=0
REDIS_CACHE_DB=1

# Install Dependencies

Next you need to install the dependencies with Composer.

$ composer install -o --no-dev

# Set the Application key

You need to set the application key with this command.

$ php artisan key:generate

# Create the Passport keys

Next you need to generate the Laravel Passport keys.

$ php artisan passport:keys

# Run the Migrations

This command will run the database migrations with seeds.

$ php artisan migrate --seed

# Run the Horizon

You need to run the Laravel Horizon for queue jobs.

$ php artisan horizon

# Run the Scheduler

You need to add the following Cron entry to your server.

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

# Configuring the Echo Server

After running laravel-echo-server init command, you need to change the socketio config.

"socketio": {
    "path": "/ws"
}

Next you need to add the /ws path to your nginx site configuration.

location /ws {
    proxy_pass http://websocket:6001;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

# Run the Echo Server

This command will start the Laravel Echo Server.

$ laravel-echo-server start

# Generate the Starmap

Estimated time: ~1 hour, Estimated size: ~4 GB

$ php artisan starmap:generate

# Final Step

You can login with the following credentials.

username: koodilab
password: havefun