# Setup on C-Panel

This section explains how to set up Shipboard on C-Panel or any other panel hosting servers.

WARNING

We recommend using VPS hosting. They are more reliable hosting solutions than shared hosts.

# Upload Shipboard

Using CPanel file manager, go to your public_html make a new folder called shipboard and upload the content of shipboard there.

CPanel Public HTML

# Configure .htaccess

Now go to public_html, and create the following .htaccess file. Replace yourdomain with your actual domain. For example in our case, we replace it with getshipboard.com

RewriteEngine on
RewriteCond %{HTTP_HOST} ^yourdomain$ [NC,OR]
RewriteCond %{HTTP_HOST} ^yourdomain$
RewriteCond %{REQUEST_URI} !shipboard/public/
RewriteRule (.*) shipboard/public/$1 [L]

# Folder Permissions

Now go inside the folder and change the permissions of the following folders storage and bootstrap/cache to 775 by right clicking on them and choosing "change permissions"

CPanel Add Domain

# Configure the Database

Now you need to create a new database and user. Go to Databases in your CPanel and create a new one called shipboard

CPanel Add Domain

Now you need to create a new user. On the same page go to create a new database user

CPanel Add Domain

Now add the user to the database

CPanel Add Domain

And select full permissions on the database to that user

CPanel Add Domain

# Configure .env File

Once you finish, you need to configure .env file on your project root folder /shipboard. Please refer to this section for more details about the .env file configuration.

# Run Installer

Before running the installer, make sure you configured .env file as explained before. After that connect to the user using SSH and go to the project root folder and run the following command:

php artisan shipboard:install

This command will run the built-in installer, and you will see the following output.

Verifying PHP version..
PHP Version is verified successfully.
Verifying PHP extensions..
PHP extensions verified successfully.
Verifying folder write permissions..
Folder permissions are verified successfully.
Generating application key..
Application key set successfully.
Application key generated successfully.
Installing the database...
...
Database installed successfully.
Configuring system settings...
System settings configured successfully.
Creating admin user..
Admin user created successfully.
Finished installing Shipboard successfully.

Now your system is ready to use!