chore(self-hosting/installtion): refactor

Author: sinanmohd

content/self-hosting/installation/apache.mdx

@@ -0,0 +1,93 @@
+---
+title: 'Behind Apache'
+description: 'Run NocoDB Behind Apache Proxy.'
+tags: ['nginx', 'proxy']
+keywords : ['NocoDB Apache', 'NocoDB Proxy']
+---
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
+
+## Prerequisites
+We assume you already have a Apache server running.
+
+## Step 1 - Run NocoDB
+
+<Tabs items={['docker', 'docker-compose', 'nix']}>
+<Tab value="docker">
+```bash
+docker run \
+	-d \
+	--name nocodb \
+	--tmpfs /run:nodev,nosuid,exec,mode=0755 \
+	-v ./nocodb:/usr/app/data \
+	-e NC_AUTH_JWT_SECRET="your-super-secret-string" \
+	-e NC_PUBLIC_URL="__your_nocodb_domain__.com" \
+	-p 8080:8080 \
+	--restart unless-stopped \
+	-it nocodb/nocodb:latest
+```
+</Tab>
+
+<Tab value="docker-compose">
+```yaml
+version: "3.9"
+services:
+  nocodb:
+    container_name: nocodb
+    image: nocodb/nocodb:latest
+    environment:
+      NC_AUTH_JWT_SECRET: 'your-super-secret-passs'
+      NC_PUBLIC_URL: '__your_nocodb_domain__.com'
+    ports:
+      - "8080:8080"
+    volumes:
+      - nocodb_data:/usr/app/data
+	tmpfs:
+      - /run:nodev,nosuid,exec,mode=0755
+volumes:
+  nocodb_data:
+```
+</Tab>
+
+<Tab value="nix">
+```bash
+nix run github:nocodb/nocodb/master
+```
+</Tab>
+</Tabs>
+
+## Step 2 - Enable the required Apache modules
+
+The Apache config shown later needs the following modules enabled.
+
+```bash
+sudo a2enmod proxy headers proxy_http proxy_wstunnel rewrite 
+sudo systemctl restart apache2
+```
+
+## Step 3 - Create the Apache config for NocoDB
+
+Create a new `nocodb.conf` in `/etc/apache2/sites-enabled/` like the following example
+
+> Make sure to replace any __nocodb_domain__ with you own domain
+
+```
+<VirtualHost *:80>
+ProxyPreserveHost On
+
+# Replace with your domain
+ServerName __nocodb_domain__
+
+ProxyPass / http://localhost:8080/
+ProxyPassReverse / http://localhost:8080/
+
+</VirtualHost>
+
+```
+
+## Step 3 - Enable the apache site
+
+```bash
+sudo a2ensite nocodb.conf
+```
+
+> You should now be able to access NocoDB on your configured domain.

content/self-hosting/installation/auto-upstall.mdx

@@ -1,5 +1,5 @@
 ---
-title: 'AWS ECS (Fargate)'
+title: 'Install on AWS'
 tags: ['Open Source']
 description: 'Deploy NocoDB on AWS ECS using Fargate'
 keywords : ['NocoDB installation', 'NocoDB AWS Fargate installation', 'NocoDB prerequisites']
@@ -111,4 +111,4 @@ This guide will walk you through deploying NocoDB on Amazon ECS using Fargate.
 - Ensure that your security groups have the correct inbound and outbound rules.
 - The NC_DB environment variable should be properly set to connect to your database.
 - Monitor the ECS console and CloudWatch logs for any deployment issues.
-- You can customize the task definition and service configuration based on your requirements.
+- You can customize the task definition and service configuration based on your requirements.

content/self-hosting/installation/aws-ecs.mdx

@@ -0,0 +1,45 @@
+---
+title: 'Install on Cloudron'
+tags: ['cloudron', 'docker']
+keywords: ['NocoDB Railway', 'Install NocoDB', 'NocoDB Docker']
+---
+
+[Cloudron](https://www.cloudron.io/) is a self-hosted platform that simplifies deploying and managing web applications. If you're using your own server and want to host **NocoDB** with auto-updates and domain management, Cloudron is a solid choice.
+
+## Prerequisites
+
+Before proceeding, ensure:
+
+* You have a working Cloudron instance set up on your server.
+* You’ve signed into the Cloudron App Store.
+* You’re comfortable using the command line and basic Cloudron CLI commands.
+
+## Deploying NocoDB on Cloudron
+
+1. Log into your Cloudron admin panel.
+
+2. Open the **App Store** from the main dashboard.
+
+   ![Cloudron App Store](/img/v2/installations/cloudron-app-store.png)
+
+3. In the search bar, type **NocoDB**.
+
+   ![Cloudron Search NocoDB](/img/v2/installations/cloudron-search-nocodb.png)
+
+4. Select the **NocoDB** app and click **Install**.
+
+   ![Cloudron Install](/img/v2/installations/cloudron-install.png)
+
+5. Configure the app’s domain, access settings, and environment variables as needed.
+
+   ![Cloudron Configure](/img/v2/installations/cloudron-configure.png)
+
+6. After installation, go to the **My Apps** section and launch your new NocoDB instance.
+
+   ![Cloudron My Apps](/img/v2/installations/cloudron-my-apps.png)
+
+## Things to Keep in Mind
+
+* **System Requirements**: Make sure your Cloudron server has enough resources (at least 1 vCPU and 1 GB RAM for testing, 2 GB+ recommended for production).
+* **Backups**: Take advantage of Cloudron’s built-in backup options to safeguard your NocoDB data.
+* **Maintenance**: Regularly update both NocoDB and Cloudron to stay current with security patches and new features.

content/self-hosting/installation/cloudron.mdx

@@ -1,42 +1,81 @@
 ---
-title: 'DigitalOcean'
+title: 'Install on DigitalOcean'
 tags: ['Open Source']
 keywords : ['NocoDB installation', 'NocoDB Digital Ocean installation', 'NocoDB prerequisites']
 ---
 
-Follow these steps to deploy NocoDB on DigitalOcean using their App Platform.
+This guide outlines how to deploy **NocoDB** on [DigitalOcean App Platform](https://www.digitalocean.com/products/app-platform), a fully managed solution for container-based applications. It covers provisioning databases, object storage, and setting environment variables for a reliable, scalable setup.
 
-### Deployment Steps
+## Step 1: Set Up Required Services
 
-1. On the DigitalOcean homepage, click on the Create icon and select "Apps (Deploy your code)".
+Since DigitalOcean App Platform doesn't support persistent volumes, NocoDB's data must be stored using **managed services**. You’ll need:
 
-    ![DigitalOcean Create App](/img/v2/installations/digitalocean-create-app.png)
-2. Choose "Docker Hub" as the source.
+* **PostgreSQL database**
+* **Redis instance**
+* **Spaces bucket (S3-compatible storage)**
 
-    ![DigitalOcean Docker Hub](/img/v2/installations/digitalocean-docker-hub.png)
+### PostgreSQL
 
-3. Set the source repository as nocodb/nocodb. You can optionally specify a release tag if you want a specific NocoDB version.
+1. Go to **Databases → Create Database**.
+2. Choose **PostgreSQL v15** and a region.
+3. Use at least 1 vCPU / 1GB RAM for smaller workloads.
+4. Once created, go to the connection info and switch to the **Connection String** view—copy this for later.
 
-   ![DigitalOcean Set Repository](/img/v2/installations/digitalocean-set-repository.png)
+### Redis
 
-4. Configure any additional settings as needed.
+1. Go to **Databases → Create Database** again.
+2. Select **Redis v7**, same region.
+3. Minimum specs: 1 vCPU / 1GB RAM.
+4. Copy the Redis connection string from the details page.
 
-   ![DigitalOcean Configure Settings](/img/v2/installations/digitalocean-configure-settings.png)
+### Spaces (Object Storage)
 
-5. Name your web service and select the nearest region for cloud hosting.
+1. Go to **Spaces Object Storage → Create Spaces Bucket**.
+2. Choose the same region used for your DB/Redis.
+3. Then go to **API → Generate New Key** to get your `Access Key` and `Secret Key`.
 
-   ![DigitalOcean Name Service](/img/v2/installations/digitalocean-name-service.png)
+## Step 2: Deploy the NocoDB App
 
-6. Choose your preferred hosting plan and click on "Launch Basic App".
+1. Navigate to **Apps → Create App**.
 
-   ![DigitalOcean Hosting Plan](/img/v2/installations/digitalocean-hosting-plan.png)
+2. Choose **Docker Hub** as the source.
 
-    Your application will be built, and the URL will be live shortly. The URL will look something like https://your-app-name.ondigitalocean.app/.
+3. Enter:
 
+* `Repository: nocodb/nocodb`
+* `Tag: latest`
 
-### Important Notes
+4. Proceed and edit the **HTTP Port** to `8080`.
 
-- Ensure you configure environment variables for database connections if needed.
-- Set up persistent storage for your NocoDB data.
-- You can scale your app as needed using DigitalOcean's App Platform.
-- Consider enabling automatic deployments for easier updates.
+5. In the environment variables section, add the following:
+
+* `NC_AUTH_JWT_SECRET`
+* `NC_PUBLIC_URL`
+* `NC_DB`
+* `NC_REDIS_URL`
+* `NC_S3_ACCESS_KEY`
+* `NC_S3_ACCESS_SECRET`
+* `NC_S3_BUCKET_NAME`
+* `NC_S3_REGION`
+* `NC_S3_ENDPOINT`
+
+> ⚠️ Ensure the `NC_PUBLIC_URL` matches your actual app domain without a trailing slash.
+
+6. Set resources to **1 container with 2GB RAM / 1 vCPU** at a minimum.
+7. Complete deployment by clicking **Create Resources**.
+
+## Step 3: Secure the Setup
+
+For PostgreSQL and Redis, add your NocoDB app as a **trusted source**:
+
+* Navigate to your database → **Settings → Trusted Sources** → Add the app.
+
+## Updating NocoDB
+
+To upgrade to a new NocoDB version:
+
+1. Go to **App Settings → Source → Edit Component**.
+2. Change the image tag (e.g., `latest`, or a specific version).
+3. Save to trigger a redeploy.
+
+You're all set! Visit your app URL to access your NocoDB workspace.