DEV Community: Bobby Orphé HOUESSINON

Useful

Bobby Orphé HOUESSINON — Tue, 25 Feb 2025 11:52:01 +0000

Difference between Docker & Kubernetes

Ritesh Kokam ・ Feb 24

Deploying a NestJS and Next.js Application on Dokku: Full-Stack Architecture

Bobby Orphé HOUESSINON — Sat, 22 Feb 2025 12:34:59 +0000

Introduction

Deploying a full-stack application that consists of a NestJS backend and a Next.js frontend on a Dokku server can be a powerful yet cost-effective solution. This article will guide you through the process of orchestrating both applications on a single Dokku instance.

Prerequisites

Before proceeding, ensure you have the following:

A server with Dokku installed (installation guide in this article)
A domain name (optional but recommended)
Basic knowledge of NestJS, Next.js, and Docker

Step 1: Setting Up the Dokku Applications

On your server, create two Dokku applications:

Create applications

dokku apps:create my-nestjs-app
dokku apps:create my-nextjs-app

Set up database and environment variables

# Example for database
dokku plugin:install https://github.com/dokku/dokku-postgres.git

dokku postgres:create mydatabase

dokku postgres:link mydatabase my-nestjs-app

# Example for environment variables
dokku config:set my-nestjs-app \
    APP_PORT=5000 \
    NGINX_ROOT=dist \
    JWT_SECRET=xxxxxxxxxxxxxxxxxx

Step 2: Configuring NestJS for Deployment

Ensure your NestJS project has a Procfile on the root folder:

web: npm run start

Then, deploy your NestJS backend:

git remote add dokku dokku@your-server-ip:my-nestjs-app
git push dokku main

Step 3: Configuring Next.js for Deployment

Next.js can be deployed similarly, but with custom environment variables:

dokku config:set my-nextjs-app \
    NEXT_PUBLIC_API_URL="https://api.yourdomain.com" \
    NGINX_ROOT=.next

Ensure your Next.js project has a Procfile:

web: npm run prod

Deploy with:

git remote add dokku dokku@your-server-ip:my-nextjs-app
git push dokku main

Step 4: Configuring Nginx and Domains

If using domains, set them up with:

dokku domains:set my-nestjs-app api.yourdomain.com
dokku domains:set my-nextjs-app yourdomain.com

Enable SSL with Let's Encrypt:

dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git
dokku letsencrypt my-nestjs-app
dokku letsencrypt my-nextjs-app

Step 5: Testing the Deployment

Verify both applications are running:

dokku logs my-nestjs-app
dokku logs my-nextjs-app

Visit https://yourdomain.com for the frontend and https://api.yourdomain.com for the backend.

Conclusion

By following this guide, you've successfully deployed a full-stack NestJS + Next.js application on a Dokku server. This setup allows for scalability, easy updates, and a structured separation between the frontend and backend.

[Boost]

Bobby Orphé HOUESSINON — Sat, 22 Feb 2025 12:00:51 +0000

Recommended Folder Structure for React 2025

Pramod Boda ・ Feb 21

#react #reactjsdevelopment #folderstructure #webdev

Deploying a Next.js Application with Dokku

Bobby Orphé HOUESSINON — Sat, 15 Feb 2025 14:20:36 +0000

Introduction

In this article, we will deploy a Next.js application using Dokku (https://dokku.com).

In a previous article, I explained how to deploy a Laravel application with Dokku, also presenting the basics of Dokku. If you are new to this tool, I recommend reading this article before continuing: Deploying a Laravel Application with Dokku, PostgreSQL and Redis.

Assuming you already have Dokku installed on your VPS, let's continue with the configurations.

1. What is Next.js

Next.js is a React framework for building modern web applications. It simplifies development by providing features like server-side rendering (SSR), static site generation (SSG), API routes, and automatic code splitting. It's widely used for building fast, SEO-friendly, and scalable applications.

The deployment process is rather simple.

2. Configuring the Next.js Application

A. Creating the Dokku Application

dokku apps:create myapp

B. Setting Environment Variables

Replace the values in the following command and execute it:

dokku config:set myapp \
    NEXT_PUBLIC_API_URL=myapi.com \
    NGINX_ROOT=.next

C. Assigning a Domain Name

dokku domains:add myapp myapp.com

3. Deployment Configuration

Based on your project structure, Dokku will recognize it as a Node.js application, use the appropriate buildpack, and execute your build script during the deployment phase.

A. `Procfile`

Create a Procfile to define the processes to be executed:

web: npm run start

4. Configuring the Local Development Machine

A. Add Remote Repository

git remote add dokku dokku@<SERVER_IP>:myapp

B. Push the Application to Dokku

git push dokku main:main

5. Enabling SSL with Let’s Encrypt (optional)

Secure your application with a free SSL certificate

dokku letsencrypt:set myapp email you@example.com
dokku letsencrypt:enable myapp

Conclusion

With this guide, your Next.js application is successfully deployed using Dokku. Thank you for reading!

Deploy a NestJS Application with Dokku

Bobby Orphé HOUESSINON — Sun, 09 Feb 2025 16:29:15 +0000

Introduction

In this article, we will deploy a NestJS application using Dokku (https://dokku.com).

In a previous article, I explained how to deploy a Laravel application with Dokku, also presenting the basics of Dokku. If you are new to this tool, I recommend reading this article before continuing: Deploying a Laravel Application with Dokku, PostgreSQL and Redis.

Assuming you already have Dokku installed on your VPS, let's continue with the configurations.

1. Setting Up Database

Dokku provides official plugins for various databases, including PostgreSQL, MySQL, MongoDB. Let's continue with PostgreSQL.

A. Installing PostgreSQL Plugin

sudo dokku plugin:install https://github.com/dokku/dokku-postgres.git postgres

B. Creating a PostgreSQL Database

dokku postgres:create myapp_db

2. Configuring the NestJS Application

A. Creating the Dokku Application

dokku apps:create myapp

B. Linking the Database

dokku postgres:link myapp_db myapp

If the database is on another server:

dokku config:set myapp DATABASE_URL=postgres://user:password@host:port/db_name

C. Setting Environment Variables

Replace the values in the following command and execute it:

dokku config:set myapp \
    APP_PORT=5000 \
    NGINX_ROOT=dist \
    NODE_ENV=production

NB: Dokku launches your application on port 5000, so you need to provide an environment variable (APP_PORT in this example) to specify the application port or set it to default to 5000.

Example:

#./main.ts

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
    const app = await NestFactory.create(AppModule);

    const appPort = process.env.APP_PORT ?? 5000;

    await app.listen(appPort);
}
bootstrap();

D. Assigning a Domain Name

dokku domains:add myapp myapp.com

3. Deployment Configuration

Based on your project structure, Dokku will recognize it as a Node.js application to use the appropriate buildpack.

A. `Procfile`

Create a Procfile to define the processes to be executed:

web: npm run prod

4. Configuring the Local Development Machine

A. Add Remote Repository

git remote add dokku dokku@<SERVER_IP>:myapp

B. Push the Application to Dokku

git push dokku main:main

5. Enabling SSL with Let’s Encrypt (optional)

Secure your application with a free SSL certificate

dokku letsencrypt:set myapp email you@example.com
dokku letsencrypt:enable myapp

Conclusion

With this guide, your NestJS application is fully deployed using Dokku. Dokku simplifies self-hosted deployments by providing a Heroku-like experience on your own server. You can now focus on building your application while leveraging a powerful and flexible deployment pipeline.

If you found this guide helpful, feel free to share it or leave a comment!

Very interesting and useful.

Bobby Orphé HOUESSINON — Thu, 06 Feb 2025 11:31:13 +0000

NodeJs 23 New Features and Improvements

kelen.cc ・ Feb 2

#javascript #node #npm

Deploying a Laravel Application with Dokku, PostgreSQL and Redis

Bobby Orphé HOUESSINON — Fri, 31 Jan 2025 19:08:41 +0000

Introduction

In this article, we will deploy a Laravel application using Dokku (https://dokku.com), a lightweight Platform-as-a-Service (PaaS) that enables you to deploy applications on your own server easily.

1. What is Dokku?

Dokku is an open-source and extensible PaaS that runs on a single server of your choice. It allows you to deploy applications using Git and manage them similarly to Heroku.

Minimum Requirements for Dokku:

A fresh installation of Ubuntu 20.04/22.04/24.04 or Debian 11+ x86_64 or arm64
At least 1GB of system memory
Optionally, a domain name pointing to your server’s IP address

2. Setting Up Dokku

A. Installing Dokku

To install the latest stable version of Dokku, run the following shell commands:

wget -NP . https://dokku.com/install/v0.35.14/bootstrap.sh
sudo DOKKU_TAG=v0.35.14 bash bootstrap.sh

This installation process takes around 5-10 minutes, depending on your internet speed.

B. Configuring SSH Key and Virtual Host Settings

To allow deployment from another machine, add its SSH key:

dokku ssh-keys:add <NAME> <PATH_TO_PUBLIC_KEY>

echo "ssh-rsa ..." | dokku ssh-keys:add <NAME>

Example:

dokku ssh-keys:add developer ~/.ssh/developer.pub

3. Setting Up Databases and Caching

Dokku provides official plugins for various databases, including PostgreSQL and Redis. We will install and configure them.

A. Installing PostgreSQL Plugin

sudo dokku plugin:install https://github.com/dokku/dokku-postgres.git postgres

B. Creating a PostgreSQL Database

dokku postgres:create myapp_db

C. Install Redis for Caching and Queues (Optional)

sudo dokku plugin:install https://github.com/dokku/dokku-redis.git redis

D. Creating a Redis Instance

dokku redis:create myapp_redis

4. Configuring the Laravel Application

A. Creating the Dokku Application

dokku apps:create myapp

B. Linking the Database and Redis

dokku postgres:link myapp_db myapp
dokku redis:link myapp_redis myapp

If the database is on another server:

dokku config:set myapp DATABASE_URL=postgres://user:password@host:port/db_name

C. Setting Environment Variables

Replace the values in the following command and execute it:

dokku config:set myapp \
    APP_DEBUG=false \
    APP_ENV=prod \
    APP_NAME="My App" \
    APP_URL=https://myapp.com \
    ASSET_URL=https://myapp.com \
    DB_CONNECTION=pgsql \
    MAIL_ENCRYPTION=ssl \
    MAIL_FROM_ADDRESS=noreply@my-app.com \
    MAIL_FROM_NAME=MyApp \
    MAIL_HOST=smtp.mailer.com \
    MAIL_MAILER=smtp \
    MAIL_PASSWORD=yourpassword \
    MAIL_PORT=2525 \
    MAIL_USERNAME=yourusername \
    NPM_CONFIG_PRODUCTION=false \
    YARN_PRODUCTION=false

D. Assigning a Domain Name

dokku domains:add myapp myapp.com

E. Persistent Storage

dokku storage:ensure-directory myapp_storage
dokku storage:mount myapp /var/lib/dokku/data/storage/myapp_storage:/app/storage

5. Deployment Configuration

To ensure smooth deployment, we need to define configuration files for Dokku in your application.

Create the following files on the root of your Laravel project

A. `.buildpacks`

Its used to tell what kind of application you need to build.

https://github.com/heroku/heroku-buildpack-nodejs
https://github.com/heroku/heroku-buildpack-php

If your application is an API then use only the heroku-buildpack-php.

B. `php.ini`

upload_max_filesize = 200m
post_max_size = 200m
memory_limit = 512M

C. `nginx.conf`

client_max_body_size 200m;

location / {
    index index.php;
    try_files $uri $uri/ /index.php$is_args$args;
}

D. `app.json`

It's used to declare the deployment scripts.

{
    "scripts": {
        "dokku": {
            "predeploy": "./.scripts/predeploy.sh",
            "postdeploy": "./.scripts/postdeploy.sh"
        }
    }
}

E. `Procfile`

Create a Procfile to define the processes to be executed:

web: vendor/bin/heroku-php-nginx -C nginx.conf -i php.ini public/
worker: php artisan queue:work --timeout=60 --sleep=3 --tries=3 --queue=high,default

Scale the processes on the server:

dokku ps:scale myapp web=1 worker=1

F. Deployment scripts

Create a .scripts folder on the root folder, then it this folder

Create predeploy.sh to optimize the application before deployment:

#!/bin/bash

mkdir -p storage/app/public
mkdir -p storage/framework/{cache/data,sessions,testing,views}
mkdir -p storage/logs

chmod -R 755 storage
chmod -R 755 public

php artisan storage:link

php artisan optimize

Create postdeploy.sh to handle database migrations after deployment:

#!/bin/bash

php artisan migrate --force

Make the scripts executable:

chmod +x -R .scripts

6. Configuring the Local Development Machine

A. Add Remote Repository

git remote add dokku dokku@<SERVER_IP>:myapp

B. Push the Application to Dokku

git push dokku main:main

C. Finalize Laravel Setup

Generate the Laravel application key:

dokku run myapp php artisan key:generate --show
dokku config:set myapp APP_KEY=<PASTE_YOUR_KEY_HERE>

7. Enabling SSL with Let’s Encrypt (optional)

Secure your application with a free SSL certificate

dokku letsencrypt:set myapp email you@example.com
dokku letsencrypt:enable myapp

Conclusion

With this setup, your Laravel application is fully deployed using Dokku with PostgreSQL and Redis. Dokku simplifies self-hosted deployments by providing a Heroku-like experience on your own server. You can now focus on building your application while leveraging a powerful and flexible deployment pipeline.

If you found this guide helpful, feel free to share it or leave a comment!

DEV Community: Bobby Orphé HOUESSINON

Useful

Difference between Docker & Kubernetes

Ritesh Kokam ・ Feb 24

Deploying a NestJS and Next.js Application on Dokku: Full-Stack Architecture

Introduction

Prerequisites

Step 1: Setting Up the Dokku Applications

Create applications

Step 2: Configuring NestJS for Deployment

Step 3: Configuring Next.js for Deployment

Step 4: Configuring Nginx and Domains

Step 5: Testing the Deployment

Conclusion

Further Reading

[Boost]

Recommended Folder Structure for React 2025

Pramod Boda ・ Feb 21

Deploying a Next.js Application with Dokku

Introduction

1. What is Next.js

2. Configuring the Next.js Application

A. Creating the Dokku Application

B. Setting Environment Variables

C. Assigning a Domain Name

3. Deployment Configuration

A. Procfile

4. Configuring the Local Development Machine

A. Add Remote Repository

B. Push the Application to Dokku

5. Enabling SSL with Let’s Encrypt (optional)

Conclusion

Deploy a NestJS Application with Dokku

Introduction

1. Setting Up Database

A. Installing PostgreSQL Plugin

B. Creating a PostgreSQL Database

2. Configuring the NestJS Application

A. Creating the Dokku Application

B. Linking the Database

C. Setting Environment Variables

D. Assigning a Domain Name

3. Deployment Configuration

A. Procfile

4. Configuring the Local Development Machine

A. Add Remote Repository

B. Push the Application to Dokku

5. Enabling SSL with Let’s Encrypt (optional)

Conclusion

Very interesting and useful.

NodeJs 23 New Features and Improvements

kelen.cc ・ Feb 2

Deploying a Laravel Application with Dokku, PostgreSQL and Redis

Introduction

1. What is Dokku?

Minimum Requirements for Dokku:

2. Setting Up Dokku

A. Installing Dokku

B. Configuring SSH Key and Virtual Host Settings

3. Setting Up Databases and Caching

A. Installing PostgreSQL Plugin

B. Creating a PostgreSQL Database

C. Install Redis for Caching and Queues (Optional)

D. Creating a Redis Instance

4. Configuring the Laravel Application

A. Creating the Dokku Application

B. Linking the Database and Redis

C. Setting Environment Variables

D. Assigning a Domain Name

E. Persistent Storage

5. Deployment Configuration

A. .buildpacks

B. php.ini

C. nginx.conf

D. app.json

E. Procfile

F. Deployment scripts

6. Configuring the Local Development Machine

A. Add Remote Repository

B. Push the Application to Dokku

A. `Procfile`

A. `Procfile`

A. `.buildpacks`

B. `php.ini`

C. `nginx.conf`

D. `app.json`

E. `Procfile`