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.You can also find links to all versions here.
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:
- Unzip the downloaded file.
- Rename the unzipped folder to any name you prefer.
- Move the renamed folder to one of your site directories. For example, you can move it to
~/Herd
. - Open your browser and visit
foldername.test
to start the installation process. Remember to replacefoldername
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:
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:
- email: [email protected]
- password: password
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.