Manual Setup

Follow those instructions step by step to set everything up.  
Check out our starter kit to get you started as fast as possible
Starter Kit
Set up your .env file
1
DB_CONNECTION=sqlite
2
DB_FOREIGN_KEYS=true
3
​
4
MOLLIE_KEY=test_XXXXXXXX
Copied!
SQLite as Database
With this setup, we will use SQLite as a file-based database. It's important to activate the foreign keys as shown above.
More information: Laravel documentation. 
MySQL as Database
If you prefer using MySQL, feel free to do so. A default setup might look similar to this example:
1
DB_CONNECTION=mysql
2
DB_HOST=127.0.0.1
3
DB_PORT=3306
4
DB_DATABASE=yourdatabasename
5
DB_USERNAME=yourusername
6
DB_PASSWORD=yourpassword
Copied!
More information: Laravel documentation. 
Publish assets
During installation, all needed assets will be published. 
We would recommend publishing the view files manually. 
Publish assets
Install the package
Require the butik package via composer
1
composer require jonassiewertsen/statamic-butik
Copied!
PHP Fatal error: Allowed memory size of 1610612736 bytes exhauste ?
It may happen that the allowed memory for composer is exhausted. This command does bypass the memory limit for this command.
1
COMPOSER_MEMORY_LIMIT=-1 composer require jonassiewertsen/statamic-butik
Copied!
Run the butik setup command
This script will migrate your database and set up some default values. Everything can be customized to a later point, but it will get you started as fast as possible.
1
php please butik:setup
Copied!
Define default country
You need to define your default country in your config file.
Config File
This country will be the default country, as long as the user does not choose another country to ship to.
This is important when deciding to ship exclusively to one country or to several countries. 
Set up Redis queues
A Redis queue driver will give your page a speed boost, especially with sending e-mails.
Butik does work with the default Laravel/Statamic setup. You don't need to set it up, we do recommend it though. 
The short and incomplete version, on how to set it up:
Add in your .env file QUEUE_DRIVER=redis
Install predis via composer composer require predis/predis
​The complete documentation​
Set up e-mails
Let me remind you to set up your e-mail settings inside the statamic env file.
Send yourself a test mail via the Statamic control panel to check if they are working correctly.
Statamic email configuration documentation​
Done
Congratulations. Your basic setup is finished.

Starter Kit

Next - Installation

Dev Setup

Last modified 10mo ago

Copy link

Contents

Set up your .env file

Run the butik setup command

Define default country

Set up Redis queues

Set up e-mails

Done