How to Backup Laravel to Filebase Using Bash
Filebase is a modern S3 compatible and cloud-managed solution to store the data in a central and safe place. It is specially designed for cloud-native applications where performance is critical. Filebase offers simple and easy-to-understand pay-as-you-go pricing. It offers a 5GB free tier to all users.
In this post, we will show you how to backup Laravel to Filebase using Bash.
Table Of Contents
- Create a Bucket on Filebase
- Install S3cmd Tool
- Configure S3cmd to Connect Laravel Server to Filebase
- Use S3cmd to Backup Laravel to Filebase Bucket
Create a Bucket on Filebase
First, you will need to create a bucket on Filebase where you want to store your Laravel databases and file. Follow the below steps to create a Filebase bucket.
Step 1 - First, sign in to your Filebase account.
Step 2 - Click on the Buckets on the left pane, you should see the following screen:
Step 3 - Click on the Create Bucket button. You should see the bucket creation screen:
Step 4 - Provide your bucker name, choose your storage location, and click the Create Bucket button. Once the bucket is created, you should see the following screen:
Step 5 - Click on the Access Keys in the left pane, you should see your Filebase access key and secrets on the following screen:
Please note down this access key, secret key, and API endpoint. You will need all to connect to the Filebase bucket.
Install S3cmd Tool
Next, you will need to install the S3cmd tool on your Laravel server from where you want to back up your Laravel database and files.
S3cmd is a free and open-source command-line tool that allows you to upload, download and manage data in Filebase bucket and other cloud storage service providers. Follow the below steps to install the S3cmd to your server.
First, install the Python and other dependencies by running the following command:
apt-get install python3 python3-setuptools curl -y
Next, download the latest version of S3cmd using the following command:
curl -LO https://github.com/s3tools/s3cmd/releases/download/v2.2.0/s3cmd-2.2.0.tar.gz
Next, extract the downloaded file with the following command:
tar -xvzf s3cmd-2.2.0.tar.gz
Next, navigate to the extracted directory and install it using the following command:
cd s3cmd-2.2.0python3 setup.py install
Once the S3cmd is installed, verify the S3cmd version using the following command:
You will get the following output:
s3cmd version 2.2.0
Configure S3cmd to Connect Laravel Server to Filebase
Next, you will need to configure the S3cmd using the Filebase Access key and Secret key. You can configure it using the following command:
You will be asked to provide your Filebase Access Key, Secret Key, Region, and Endpoint as shown below:
Enter new values or accept defaults in brackets with Enter.Refer to user manual for detailed description of all options.Access key and Secret key are your identifiers for Amazon S3. Leave them empty for using the env variables.Access Key: 54203D2S91DA6F043A3DSecret Key: JSo3sFt7vMF1v3iISArDwWvzSHsPlSsroaL1591ADefault Region [US]: us-east-1Use "s3.amazonaws.com" for S3 Endpoint and not modify it to the target Amazon S3.S3 Endpoint [s3.amazonaws.com]: s3.filebase.comUse "%(bucket)s.s3.amazonaws.com" to the target Amazon S3. "%(bucket)s" and "%(location)s" vars can be usedif the target S3 system supports dns based buckets.DNS-style bucket+hostname:port template for accessing a bucket [%(bucket)s.s3.amazonaws.com]: %(bucket)s.s3.filebase.comEncryption password is used to protect your files from readingby unauthorized persons while in transfer to S3Encryption password:Path to GPG program [/usr/bin/gpg]:When using secure HTTPS protocol all communication with Amazon S3servers is protected from 3rd party eavesdropping. This method isslower than plain HTTP, and can only be proxied with Python 2.7 or newerUse HTTPS protocol [Yes]:On some networks all internet access must go through a HTTP proxy.Try setting it here if you can't connect to S3 directlyHTTP Proxy server name:New settings:Access Key: 54203D2S91DA6F043A3DSecret Key: JSo3sFt7vMF1v3iISArDwWvzSHsPlSsroaL1591ADefault Region: us-east-1S3 Endpoint: s3.filebase.comDNS-style bucket+hostname:port template for accessing a bucket: %(bucket)s.s3.filebase.comEncryption password:Path to GPG program: /usr/bin/gpgUse HTTPS protocol: TrueHTTP Proxy server name:HTTP Proxy server port: 0Test access with supplied credentials? [Y/n] YPlease wait, attempting to list all buckets...Success. Your access key and secret key worked fine :-)Now verifying that encryption works...Not configured. Never mind.Save settings? [y/N] y
Once the S3cmd is configured, you can verify your Filebase Bucket information using the following command:
s3cmd info s3://laravel-filebase/
You will get the following output:
s3://laravel-filebase/ (bucket):Location: us-east-1Payer: noneExpiration Rule: nonePolicy: <?xml version="1.0" encoding="UTF-8"?><ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><Name>laravel-filebase</Name><Prefix/><Marker/><MaxKeys>1000</MaxKeys><IsTruncated>false</IsTruncated></ListBucketResult>CORS: noneACL: email@example.com: FULL_CONTROL
Use S3cmd to Backup Laravel to Filebase Bucket
First, log in to your Laravel server and connect to the MariaDB shell with the following command:
mysql -u root -p
Once you are logged in, list all available databases using the following command:
MariaDB [(none)]> show databases;+--------------------+| Database |+--------------------+| information_schema || laraveldb || Laravel || performance_schema |+--------------------+
Next, backup your laravel database with the following command:
mysqldump -u laraveluser -p laraveldb > laravel.sql
Next, run the S3cmd command to copy the laraveldb.sql file to the Filebase Bucket:
s3cmd put laravel.sql s3://laravel-filebase/
You should see the following output:
upload: 'laravel.sql' -> 's3://laravel-filebase/laravel.sql' [1 of 1]10485760 of 10485760 100% in 1s 7.75 MB/s done
Next, run the S3cmd command again to copy the Laravel website data to the Filebase Bucket:
tar -czvf - /var/www/html/laravel | s3cmd put - s3://laravel-filebase/laravel.tar.gz
upload: '<stdin>' -> 's3://laravel-filebase/laravel.tar.gz' [part 2 of -, 5MB] [1 of 1]5433321 of 5433321 100% in 0s 15.29 MB/s done
You can now verify all Laravel backups on the Filebase Bucket using the following command:
s3cmd ls s3://laravel-filebase
You will get the following output:
2022-07-15 05:34 10485760 s3://laravel-filebase/laravel.sql2022-07-15 05:34 21161961 s3://laravel-filebase/laravel.tar.gz
You can also log in to the Filebase Bucket and verify your Laravel backup files as shown below:
In this post, we explained how to backup the Laravel database and website data to Filebase using bash. You can now easily copy your Laravel database and files to Filebase Bucket via the s3cmd tool.
Thank you for helping us improve!