惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

GbyAI
GbyAI
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
IT之家
IT之家
K
KPMG report finds enterprise disconnect between AI and its ROI | CIO
N
News | PayPal Newsroom
Cloudbric
Cloudbric
Webroot Blog
Webroot Blog
www.infosecurity-magazine.com
www.infosecurity-magazine.com
Simon Willison's Weblog
Simon Willison's Weblog
Spread Privacy
Spread Privacy
Threat Intelligence Blog | Flashpoint
Threat Intelligence Blog | Flashpoint
V
Vulnerabilities – Threatpost
Attack and Defense Labs
Attack and Defense Labs
C
Cyber Attacks, Cyber Crime and Cyber Security
Cisco Talos Blog
Cisco Talos Blog
C
Cybersecurity and Infrastructure Security Agency CISA
H
Hackread – Cybersecurity News, Data Breaches, AI and More
P
Proofpoint News Feed
阮一峰的网络日志
阮一峰的网络日志
S
Secure Thoughts
T
Tor Project blog
Latest news
Latest news
aimingoo的专栏
aimingoo的专栏
V2EX - 技术
V2EX - 技术
Exploit-DB.com RSS Feed
Exploit-DB.com RSS Feed
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
S
Securelist
T
Tenable Blog
N
Netflix TechBlog - Medium
Google Online Security Blog
Google Online Security Blog
博客园 - Franky
T
Troy Hunt's Blog
量子位
大猫的无限游戏
大猫的无限游戏
T
Threat Research - Cisco Blogs
T
The Exploit Database - CXSecurity.com
MongoDB | Blog
MongoDB | Blog
H
Heimdal Security Blog
D
Docker
W
WeLiveSecurity
Stack Overflow Blog
Stack Overflow Blog
G
Google Developers Blog
博客园 - 叶小钗
腾讯CDC
The Hacker News
The Hacker News
WordPress大学
WordPress大学
人人都是产品经理
人人都是产品经理
Project Zero
Project Zero
Martin Fowler
Martin Fowler

DEV Community

Authentication Security Deep Dive: From Brute Force to Salted Hashing (With Java Examples) Why AI Systems Don’t Fail — They Drift Spilling beans for how i learn for exam😁"Reinforcement Learning Cheat Sheet" I Replaced Chrome with Safari for AI Browser Automation. Here's What Broke (and What Finally Worked) How Python Borrows Other People's Work The $40 Architecture: Processing 1 Billion API Requests with 99.99% Uptime Vibe Coding: A Workflow Guide (From Zero to SaaS) Most webhook security guides protect the wrong side. The scary part is delivery. Headless CMS for TanStack Start: Build a Blog with Cosmic EU Age Verification App "Hacked in 2 Minutes" — What Actually Happened Comfy Cloud’s delete function does not actually remove files Running AI Models on GPU Cloud Servers: A Beginner Guide Event-driven media intelligence with AWS Step Functions and Bedrock I scored 500 AI prompts across 8 quality dimensions — here's what broke How to Call Google Gemini API from Next.js (Free Tier, No Backend Needed) The Portal Protocol: Reclaiming Human Connection in the Age of AI How to Fix Your Team's Scattered Knowledge Problem With a Self-Hosted Forum Intro to tc Cloud Functors: A Graph-First Mental Model for the Modern Cloud Designing Multi-Tenant Backends With Both Ownership and Team Access I Built a Neumorphic CSS Library with 77+ Components — Here's What I Learned PostgreSQL Performance Optimization: Why Connection Pooling Is Critical at Scale Cómo construí un SaaS multi-rubro para gestionar expensas en Argentina con FastAPI + Vue 3 🚀 I Built an Ethical Hacking Scanner Tool – Open Source Project I Replaced /usage and /context in Claude Code With a Single Statusline A Pythonic Way to Handle Emails (IMAP/SMTP) with Auto-Discovery and AI-Ready Design I Collected 8.9 Million Polymarket Price Points — Here's What I Found About How Markets Really Move EcoTrack AI — Carbon Footprint Tracker & Dashboard Everyone's Using AI. No One Agrees How. 5 self-hosted ebook managers worth trying in 2026 Building Your First AI Agent with LangChain: From Chatbot to Autonomous Assistant Common SOC 2 Failures (Real World) Stop Vibe-Checking Your AI App: A Practical Guide to Evals How to Use SonarQube and SonarScanner Locally to Level Up Your Code Quality Your Next To-Do App Is Dead — I Replaced Mine with an OpenClaw AI Sign a Nostr event in 60 lines of Python using coincurve — no nostr-sdk, no nbxplorer, no rust toolchain ITGC Audit Explained Like You’re in Big 4 Patch Tuesday abril 2026: Microsoft parcha 163 vulnerabilidades y un zero-day en SharePoint Stop scraping everything: a better way to track competitor price changes Listing on MCPize + the Official MCP Registry while routing payments OUTSIDE the marketplace — how I kept 100% of my x402 revenue Building an AI-Powered Risk Intelligence System Using Serverless Architecture Why We Ripped Function Overloading Out of Our AI Toolchain Testing AI-Generated Code: How to Actually Know If It Works SaaS Churn Is Killing Your Business. Here Is What to Do About It (Without a Support Team) The Speed of AI Is No Longer Linear - And Self-Improving Models Are Why How to Implement RBAC for MCP Tools: A Practical Guide for Engineering Teams From Standard Quote to Persuasive Proposal: AI Automation for Arborists I built a CLI that scaffolds complete multi-tenant SaaS apps Axios CVE-2025–62718: The Silent SSRF Bug That Could Be Hiding in Your Node.js App Right Now The dashboard that ended our friendship Data Pipelines Explained Simply (and How to Build Them with Python) The Hidden Cost of AI Systems Nobody Talks About. undefined vs undeclared, and how typeof behaves Switching from file-based jobs to NATS/Kafka in Rust without changing code io_uring Adventures: Rust Servers That Love Syscalls Why Agentic AI is Killing the Traditional Database The POUR principles of web accessibility for developers and designers Quantum Neural Network 3D — A Deep Dive into Interactive WebGL Visualization How To Install Caveman In Codex On macOS And Windows Automation Pipeline Reliability: Why Your Workflow Breaks When Nobody Is Watching I Built an 'Open World' AI Coding Agent — It Works From ANY Folder From Freelancing to Product: A Tech Service Company's SaaS Transformation China's AI Giants: Adding Tencent Hunyuan & ByteDance Doubao to AI University (74 Providers) On the Vibe Coders and Their Lies clerk: Auto-Summarize Your Claude Code Sessions AI Weekly — 2026/04/10–04/17 | The Model Lockdown Is Here, but the Toolchain Is the Real Battleground AI 週報 — 2026/04/10–2026/04/17 模型封鎖潮來了,但工具鏈才是真戰場 Maybe this is how Open-Source apps are born... 🚀 Fine-Tune LLMs with LoRA and QLoRA: 2026 Guide tRPC v11 + Next.js App Router: End-to-End Type Safety Without the Boilerplate ShadCN UI in 2026: Why I Stopped Installing Component Libraries and Started Owning My Components SaaS Billing in React Server Components: Stripe + Supabase Without a Single `useEffect` Join our DEV Weekend Challenge — $1,000 in Prizes Across TEN winners! Submissions Due April 20 at 6:59 AM UTC. Implementing FSRS Spaced Repetition in Flutter + Supabase — Adding Memory Science to an AI Learning App "I Texted My Localhost From the Train — Claude Code Fixed the Bug Before I Got Home" I Built a Sales Prep AI and It Went Deeper Than Expected Design to Code #2: One JSON, Eleven Outputs Solving the 100M-Row Problem: A Summary Table Pattern for High-Volume Push Notification Logs Flutter Web With Wasm: What Actually Changes For Developers I Built 50 Royalty-Free Soundtracks for My Side Project in a Weekend Using AI Music Generation The Vibe Coding Security Checklist: 7 Things to Check Before You Ship Stop Letting Googlebot Guess Fix Your React App's SEO Right Desconstruindo o Streaming do LinkedIn: Como Criar um Engine de Extração de Vídeo de Alta Performance com HLS e FFmpeg (EDA Part-1) EDA (Exploratory Data Analysis) Explained With Real Life — Why Looking at Your Data Is the Most Important Step in Machine Learning Brand Relationship Management at Scale: Our 4-Touch Outreach System for 200+ Brands Why String.fromEnvironment() Might Return an Empty String in Dart JGuardrails 1.0.0 — Hardening Java LLM Apps Against Jailbreaks, Toxicity, and Prompt Injection Plan and Schedule a Full Week of Threads Content From One Claude Conversation Coding Cat Oran Ep3, Five Tables Changed Everything Updated: BFF Pattern I'm done watching freelancers get buried by 200 proposals. So I'm building the alternative. This is my first post BFS Algorithm in Java Step by Step Tutorial with Examples Tracking LLM Pricing Monthly: An Open Dataset for 22 AI Models How We Measure Content ROI on a Comparison Site: Revenue Attribution Without Perfect Data Introducing Nova AI Ops: The AI-Native Operating System for SRE Teams I built a free desktop video downloader for Windows — Grabbit How Talkie OCR Helps Vision-Impaired & Dyslexic Users Read the World Around Them VRCFaceTracking安装和iPhone面捕配置教程,有bug Even CrowdStrike Can't See Your Agents The Automation Gold Rush: What n8n Workflows and Claude Are Opening Up for Developers Right Now
How to Auto-Deploy a Laravel App to DigitalOcean Using GitHub Actions
Jenuel Oras · 2026-05-17 · via DEV Community

How to Auto-Deploy a Laravel App to DigitalOcean Using GitHub Actions

Deploying a Laravel application manually can become repetitive, especially when you frequently push updates to production. Instead of logging in to your server through SSH every time, you can automate the deployment process using GitHub Actions.

In this guide, you will learn how to set up a simple CI/CD workflow that automatically deploys your Laravel app to a DigitalOcean Droplet every time you push changes to the main branch.

With this setup, your workflow will look like this:

Push to main → GitHub Actions runs → SSH into Droplet → Pull latest code → Install dependencies → Build assets → Run migrations → Optimize Laravel → Restart queue workers

Enter fullscreen mode Exit fullscreen mode


What You Will Need

Before starting, make sure you already have the following:

  • A Laravel application hosted on GitHub

  • A DigitalOcean Droplet running Ubuntu

  • Your Laravel app already set up and working on the Droplet

  • Nginx or Apache configured for your Laravel app

  • PHP, Composer, Node.js, and npm installed on the server

  • Database connection already configured in your .env file

  • SSH access to your Droplet

  • Basic knowledge of GitHub repository settings

For better security, it is recommended to use a dedicated deploy user instead of the root user. However, this guide will use root in the examples to keep the setup simple. If you are deploying a production application, consider creating a separate limited-access user for deployments.


Step 1: Create a Laravel Deploy Script

First, create a deploy command inside your package.json file. This allows GitHub Actions to run one command on your server instead of writing all deployment commands directly inside the workflow file.

Open your package.json and add the following script:

"scripts": {
  "deploy": "git pull && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader && npm ci && npm run build && php artisan migrate --force && php artisan config:cache && php artisan route:cache && php artisan view:cache && php artisan optimize"
}

Enter fullscreen mode Exit fullscreen mode

If your project does not have a package-lock.json file, use npm install instead of npm ci:

"scripts": {
  "deploy": "git pull && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader && npm install && npm run build && php artisan migrate --force && php artisan config:cache && php artisan route:cache && php artisan view:cache && php artisan optimize"
}

Enter fullscreen mode Exit fullscreen mode

What Each Command Does

Command Purpose
git pull Pulls the latest code from GitHub
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader Installs production PHP dependencies and optimizes Composer autoloading
npm ci Installs JavaScript dependencies using the lock file for consistent builds
npm run build Builds frontend assets for production
php artisan migrate --force Runs database migrations in production mode
php artisan config:cache Caches Laravel configuration
php artisan route:cache Caches Laravel routes
php artisan view:cache Compiles and caches Blade views
php artisan optimize Runs Laravel optimization commands

Important: Running php artisan migrate --force on production can change your database structure. Always make sure your migrations are tested and that you have a database backup strategy before deploying.


Step 2: Create the GitHub Actions Workflow

Next, create a GitHub Actions workflow file inside your Laravel project.

Create this file:

.github/workflows/deploy.yml

Enter fullscreen mode Exit fullscreen mode

Then add the following workflow:

name: Deploy to Production

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Deploy via SSH
        uses: appleboy/ssh-action@v1.2.0
        with:
          host: ${{ secrets.DROPLET_HOST }}
          username: ${{ secrets.DROPLET_USER }}
          key: ${{ secrets.DROPLET_SSH_KEY }}
          script: |
            cd /var/www/your-app
            npm run deploy
            php artisan queue:restart

Enter fullscreen mode Exit fullscreen mode

Replace this path with the actual location of your Laravel app on the Droplet:

/var/www/your-app

Enter fullscreen mode Exit fullscreen mode

For example:

script: |
  cd /var/www/my-laravel-app
  npm run deploy
  php artisan queue:restart

Enter fullscreen mode Exit fullscreen mode

The php artisan queue:restart command tells Laravel queue workers to restart gracefully so they can use the newly deployed code. If you are using Supervisor to manage your queue workers, Supervisor will automatically start them again.


Step 3: Generate a Deploy SSH Key on Your Local Machine

GitHub Actions needs SSH access to your Droplet. Instead of using your personal SSH key, it is better to create a dedicated SSH key for deployment.

Run this command on your local machine:

ssh-keygen -t ed25519 -C "your-app-github-deploy" -f ~/.ssh/your-app-github -N ""

Enter fullscreen mode Exit fullscreen mode

This will create two files:

File Purpose
~/.ssh/your-app-github Private key. This will be added to GitHub Secrets.
~/.ssh/your-app-github.pub Public key. This will be added to your Droplet.

Do not share the private key publicly. It should only be stored in GitHub Secrets.


Step 4: Add the Public Key to Your Droplet

Now add the public key to your Droplet so GitHub Actions can connect through SSH.

Mac or Linux

ssh-copy-id -i ~/.ssh/your-app-github.pub root@YOUR_DROPLET_IP

Enter fullscreen mode Exit fullscreen mode

Windows PowerShell

type $env:USERPROFILE\.ssh\your-app-github.pub | ssh root@YOUR_DROPLET_IP "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys"

Enter fullscreen mode Exit fullscreen mode

Replace YOUR_DROPLET_IP with your actual DigitalOcean Droplet IP address.

You can test the SSH connection using:

ssh -i ~/.ssh/your-app-github root@YOUR_DROPLET_IP

Enter fullscreen mode Exit fullscreen mode

If the connection works, GitHub Actions should also be able to connect once the private key is added to your repository secrets.


Step 5: Create a GitHub Deploy Key on the Droplet

Your GitHub Actions workflow can now connect to the Droplet, but the Droplet also needs permission to pull code from your GitHub repository.

SSH into your Droplet:

ssh root@YOUR_DROPLET_IP

Enter fullscreen mode Exit fullscreen mode

Then generate a new SSH key on the Droplet:

ssh-keygen -t ed25519 -C "your-app-droplet-deploy" -f ~/.ssh/your-app-github -N ""

Enter fullscreen mode Exit fullscreen mode

Print the public key:

cat ~/.ssh/your-app-github.pub

Enter fullscreen mode Exit fullscreen mode

Copy the output, then go to your GitHub repository:

Settings → Deploy keys → Add deploy key

Enter fullscreen mode Exit fullscreen mode

Add the deploy key using these values:

Field Value
Title DigitalOcean Droplet
Key Paste the public key from the Droplet
Allow write access Leave unchecked

Read-only access is enough because the Droplet only needs to pull code from GitHub.

After adding the deploy key, configure SSH on the Droplet to use this key when connecting to GitHub:

cat >> ~/.ssh/config <<'EOF'
Host github.com
  IdentityFile ~/.ssh/your-app-github
  StrictHostKeyChecking no
EOF

chmod 600 ~/.ssh/config

Enter fullscreen mode Exit fullscreen mode

Test if the Droplet can connect to GitHub:

ssh -T git@github.com

Enter fullscreen mode Exit fullscreen mode

If the key is configured correctly, GitHub should recognize the connection.


Step 6: Add GitHub Repository Secrets

Now add the SSH connection details to GitHub Secrets.

Go to your GitHub repository:

Settings → Secrets and variables → Actions → New repository secret

Enter fullscreen mode Exit fullscreen mode

Add the following secrets:

Secret Name Value
DROPLET_HOST Your Droplet IP address
DROPLET_USER Your SSH user, for example root
DROPLET_SSH_KEY The full contents of your local private key

To get the private key contents from your local machine:

Mac or Linux

cat ~/.ssh/your-app-github

Enter fullscreen mode Exit fullscreen mode

Windows PowerShell

cat $env:USERPROFILE\.ssh\your-app-github

Enter fullscreen mode Exit fullscreen mode

Copy everything, including these lines:

-----BEGIN OPENSSH PRIVATE KEY-----
...
-----END OPENSSH PRIVATE KEY-----

Enter fullscreen mode Exit fullscreen mode

Paste the full private key into the DROPLET_SSH_KEY secret.


Step 7: Push and Test the Deployment

After setting up the deploy script and workflow file, commit and push your changes to the main branch:

git add .github/workflows/deploy.yml package.json
git commit -m "Add auto-deploy pipeline"
git push origin main

Enter fullscreen mode Exit fullscreen mode

Then go to your GitHub repository and open the Actions tab.

If everything is configured correctly, you should see the deployment workflow running. A green checkmark means the deployment completed successfully.


How the Deployment Process Works

Here is the full process:

You push changes to main
        ↓
GitHub Actions starts the deployment workflow
        ↓
GitHub Actions connects to your Droplet through SSH
        ↓
The workflow goes to your Laravel project directory
        ↓
The server runs npm run deploy
        ↓
Laravel pulls the latest code from GitHub
        ↓
Composer installs production dependencies
        ↓
Node builds frontend assets
        ↓
Laravel runs migrations and optimization commands
        ↓
Queue workers restart gracefully
        ↓
Deployment is complete

Enter fullscreen mode Exit fullscreen mode

This removes the need to manually SSH into your server every time you want to deploy updates.


Troubleshooting Common Issues

git@github.com: Permission denied (publickey)

This usually means your Droplet does not have permission to pull from your GitHub repository.

To fix this:

  • Make sure you generated an SSH key on the Droplet.

  • Make sure the Droplet public key was added to GitHub Deploy Keys.

  • Make sure the repository remote uses SSH instead of HTTPS.

Check your remote URL:

git remote -v

Enter fullscreen mode Exit fullscreen mode

It should look like this:

git@github.com:username/repository.git

Enter fullscreen mode Exit fullscreen mode

If it uses HTTPS, update it:

git remote set-url origin git@github.com:username/repository.git

Enter fullscreen mode Exit fullscreen mode


composer: Continue as root/super user [yes]?

If you are deploying as root, Composer may show a warning. The deploy script uses this environment variable to avoid the prompt:

COMPOSER_ALLOW_SUPERUSER=1

Enter fullscreen mode Exit fullscreen mode

A better long-term solution is to use a dedicated deploy user instead of root.


npm ci Fails

The npm ci command requires a package-lock.json file. If your project does not have one, use npm install instead.

You can also generate a lock file locally by running:

npm install

Enter fullscreen mode Exit fullscreen mode

Then commit the generated package-lock.json file.


.ssh/authorized_keys: No such file or directory

Create the .ssh directory and authorized_keys file manually:

mkdir -p ~/.ssh
touch ~/.ssh/authorized_keys
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

Enter fullscreen mode Exit fullscreen mode

Then add your public key again.


Queue Workers Are Not Using the New Code

Restart Laravel queue workers after deployment:

php artisan queue:restart

Enter fullscreen mode Exit fullscreen mode

If you are using Supervisor, check the worker status:

sudo supervisorctl status

Enter fullscreen mode Exit fullscreen mode

If needed, restart the workers manually:

sudo supervisorctl restart all

Enter fullscreen mode Exit fullscreen mode


GitHub Actions Connects to the Server but Deployment Fails

Check the workflow logs in GitHub Actions. Common causes include:

  • Incorrect app path in the workflow file

  • Missing Composer on the server

  • Missing Node.js or npm on the server

  • Wrong file permissions

  • Failed Laravel migration

  • Failed frontend build

  • Missing environment variables in .env

You can also manually test the deploy command directly on the server:

cd /var/www/your-app
npm run deploy

Enter fullscreen mode Exit fullscreen mode

If it fails manually, fix the server-side issue first before running GitHub Actions again.


Security Recommendations

For a simple personal project, deploying as root may work. However, for production applications, it is better to improve security by following these practices:

  • Use a dedicated deploy user instead of root.

  • Give the deploy user access only to the application directory.

  • Keep your private SSH key only in GitHub Secrets.

  • Do not commit private keys to your repository.

  • Use read-only GitHub deploy keys for pulling code.

  • Make sure your .env file is never committed.

  • Back up your database before running production migrations.


Finally! 😁🫡

You now have a simple automated deployment pipeline for Laravel using GitHub Actions and a DigitalOcean Droplet.

Every time you push to the main branch, GitHub Actions will connect to your server, pull the latest code, install dependencies, build assets, run migrations, optimize Laravel, and restart queue workers.

This setup is a practical starting point for automating Laravel deployments without needing a complex deployment platform. As your application grows, you can improve this workflow further by adding deployment notifications, database backups, test runs, zero-downtime deployment, and rollback support.


If you enjoy this article and would like to show your support, you can easily do so by buying me a coffee. Your contribution is greatly appreciated!

Buy Me A Coffee