Back to DevDojo Home

Installing Wave

To install Wave you will need a local PHP development environment setup on your machine. The easiest way to do this is by downloading and installing Laravel Herd. After you have done that, we can move on to the next step and download Wave.

Download Wave

To download a fresh copy of Wave, click the download button below.

After downloading Wave, you have two installation options. If you’re using Herd, select the Automated Installer. Otherwise, proceed with the Manual Installation.

Automated Installation with Herd

If you are using Herd to host your sites locally, you can follow these steps to finish the installation via the automated installer:

  1. Unzip the downloaded file.
  2. Rename the unzipped folder to any name you prefer.
  3. Move the renamed folder to one of your site directories. For example, you can move it to ~/Herd.
  4. Open your browser and visit foldername.test to start the installation process. Remember to replace foldername with the actual name of the folder.

That's it! Wave is now installed. If you encounter any errors during the automated installer, you may follow the steps to manually install below; otherwise, move on to the Database section.

Manual Installation

If you are hosting your Laravel projects locally with someting other than Hered, or if receive an error during the automated installer, you may want to manually install Wave. To do so, continue reading.

Download Wave and unzip the file. Next, move the folder to your sites folder, and follow these steps:

1. Copy .env.example file

From inside the project folder, run the following command:

cp .env.example .env

2. Install Composer Dependencies

Next, we need to install the composer dependencies:

composer install

3. Database Migrations and Seed

Next, we need to migrate and seed the database:

php artisan migrate
php artisan db:seed

Wave has now been installed. Raise the anchor, man the helm, and prepare for the voyage ahead!

Database

By default Wave uses an SQLite connection stored at database/database.sqlite. If you wish, you can change this connection from inside your .env file. As an example, this is how a MySQL connection will look:

.env

CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=database-name
DB_USERNAME=root
DB_PASSWORD=''

In most cases SQLite will work totally fine.

Logging into your Application

After installing Wave, you should automatically be logged in as the admin user. If you need to log in again, you can use the following credentials:

Once you've logged in, you can modify the admin email, username, and password by accessing the settings section within the user menu.


Next, we'll cover a few more local development commands.