{"id":275,"date":"2017-07-03T08:27:56","date_gmt":"2017-07-03T08:27:56","guid":{"rendered":"https:\/\/blog.a2design.biz\/?p=275"},"modified":"2026-08-31T23:08:21","modified_gmt":"2026-08-31T23:08:21","slug":"deploying-laravel-projects","status":"publish","type":"post","link":"https:\/\/www.a2design.biz\/blog\/deploying-laravel-projects\/","title":{"rendered":"Deploying Laravel Projects"},"content":{"rendered":"\n

To deploy Laravel projects on remote servers, we follow the nine steps outlined below (usually the server runs Ubuntu OS). <\/p>\n\n\n\n

All the steps are executed through SSH.<\/p>\n\n\n\n

Preparing the Remote Server<\/strong><\/p>\n\n\n\n

    \n
  1. Create the repository directory. We usually name it repository<\/strong> or repo<\/strong> for short.<\/li>\n\n\n\n
  2. Inside the repository directory, create another directory with the name of your project. It would look something like this: repository\/yourProjectName.git\/<\/strong><\/li>\n\n\n\n
  3. Inside your project directory, initialize the git repository by executing the following bash command: git bash init –bare<\/strong>. The –bare<\/strong> option is used to initialize the version control system without including the source project files in the directory. <\/li>\n\n\n\n
  4. Create the post-receive<\/strong> file.
    Inside repository\/yourProjectName.git\/hooks\/<\/strong>, create a file and name it post-receive<\/strong>.
    Now execute the bash commands in post-receive<\/strong>: 
    \u201cgit –work-tree=\/var\/www\/yourDomain\/ –git-dir=\u201d\/home\/userName\/repository\/yourProjectName.git checkout -f<\/strong>“, \u201csh var\/www\/yourDomain\/build\/build.sh<\/strong>\u201d. The first command will deploy files to the project directory, while the second command will run the bash script for implementation of our bash commands for the project (more about that later). <\/li>\n\n\n\n
  5. Give <\/strong>proper permissions to post-receive<\/strong>. Run chmod +x post-receive<\/strong> inside of repository\/yourProjectName.git\/hooks\/<\/strong> to give permissions to the file post-receive <\/strong>to be executed. <\/li>\n\n\n\n
  6. Install the LEMP stack (Linux Nginx MySQL PHP). For our projects, we typically use the LEMP stack with modern versions of its modules. You can find all the details on how to install and configure a LEMP stack at the following URL: there<\/a>. <\/li>\n\n\n\n
  7. Install a package manager. Laravel requires package managers in order to install dependencies. Example package managers include Composer for PHP projects or NPM for JavaScript.

    Prepare Local Project<\/strong><\/li>\n\n\n\n
  8. We now need to configure our project for deployment, check and add unwanted files or directory to \u201cgitignore<\/strong>\u201d, and create \u201cbuild.sh\u201d<\/strong>. <\/li>\n<\/ol>\n\n\n\n

    Example of build.sh<\/strong>:<\/p>\n\n\n

    ROOT_DIR=\u201d\/home\/userName\/repository\/yourProjectName.git\u201d\nCOMPOSER_DIR=\u201d\/home\/userName\/.composer\u201d\n\nif<\/span> [ ! -f ${COMPOSER_DIR}\/composer.phar ]; then\nphp -r \"readfile('https:\/\/getcomposer.org\/installer');\"<\/span> | php -- --install-dir=${ROOT_DIR}\nfi\nPHP_PATH=\"\/usr\/bin\/php-7.2\"<\/span>\n\n${ROOT_DIR} ${COMPOSER_DIR}\/composer.phar install -d ${ROOT_DIR}\n${ROOT_DIR} ${COMPOSER_DIR}\/composer.phar dumpautoload\n\nchmod -R 777<\/span> ${ROOT_DIR}\/storage\/\nchmod -R 777<\/span> ${ROOT_DIR}\/bootstrap\/cache\/\n\n${PHP_PATH} ${ROOT_DIR}\/artisan migrate --force\n${PHP_PATH} ${ROOT_DIR}\/artisan view:clear\n${PHP_PATH} ${ROOT_DIR}\/artisan cache:clear\n${PHP_PATH} ${ROOT_DIR}\/artisan clear-compiled\n${PHP_PATH} ${ROOT_DIR}\/artisan optimize\n\ncd ${ROOT_DIR}\nnpm install\nnpm run prod\necho<\/span> \"Done..!\"<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    \n\nThis method of deploying Laravel projects is the most common. However, for some situations, the specific directory paths, package managers, or server configuration might change.  \n\n<\/p>\n
    Now add a remote branch by executing git remote add beta ssh:\/\/<\/strong>user@ip_or_domain\/<\/strong><\/a>home\/userName\/repository\/yourProjectName.git<\/strong>.You can now run the git push live master<\/strong> git command to start the deployment process.After the files have finished loading to the remote server, build.sh executes all the instructions. <\/p>\n\n\n\n