[RELEASE] v3.1.7-beta (#181)

- Added "namePlaceholder" to share creation modals across multiple languages for improved user guidance.
- Updated error messages in various languages to maintain consistency and clarity.
- Introduced "filesQueued" message for better user feedback during file uploads in multiple languages.

Dockerfile

@@ -82,7 +82,7 @@ RUN addgroup --system --gid ${PALMR_GID} nodejs
 RUN adduser --system --uid ${PALMR_UID} --ingroup nodejs palmr
 
 # Create application directories 
-RUN mkdir -p /app/palmr-app /app/web /home/palmr/.npm /home/palmr/.cache
+RUN mkdir -p /app/palmr-app /app/web /app/infra /home/palmr/.npm /home/palmr/.cache
 RUN chown -R palmr:nodejs /app /home/palmr
 
 # === Copy Server Files to /app/palmr-app (separate from /app/server for bind mounts) ===
@@ -117,10 +117,13 @@ WORKDIR /app
 # Create supervisor configuration
 RUN mkdir -p /etc/supervisor/conf.d
 
-# Copy server start script
+# Copy server start script and configuration files
 COPY infra/server-start.sh /app/server-start.sh
+COPY infra/configs.json /app/infra/configs.json
+COPY infra/providers.json /app/infra/providers.json
+COPY infra/check-missing.js /app/infra/check-missing.js
 RUN chmod +x /app/server-start.sh
-RUN chown palmr:nodejs /app/server-start.sh
+RUN chown -R palmr:nodejs /app/server-start.sh /app/infra
 
 # Copy supervisor configuration
 COPY infra/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
@@ -133,7 +136,7 @@ set -e
 echo "Starting Palmr Application..."
 echo "Storage Mode: \${ENABLE_S3:-false}"
 echo "Secure Site: \${SECURE_SITE:-false}"
-echo "Encryption: \${DISABLE_FILESYSTEM_ENCRYPTION:-false}"
+echo "Encryption: \${DISABLE_FILESYSTEM_ENCRYPTION:-true}"
 echo "Database: SQLite"
 
 # Set global environment variables

apps/docs/content/docs/3.1-beta/api.mdx

@@ -30,8 +30,6 @@ services:
 ```bash
 docker run -d \
   --name palmr \
-  -e ENABLE_S3=false \
-  -e ENCRYPTION_KEY=change-this-key-in-production-min-32-chars \
   -p 5487:5487 \
   -p 3333:3333 \
   -v palmr_data:/app/server \

apps/docs/content/docs/3.1-beta/architecture.mdx

@@ -45,9 +45,9 @@ Palmr. uses **filesystem storage** as the default storage solution, keeping thin
 
 #### Performance Considerations with Encryption
 
-By default, filesystem storage uses encryption (AES-256-CBC) to protect files at rest, which adds CPU overhead during uploads (encryption) and downloads (decryption). This can make operations slower and consume more resources, particularly for large files or in resource-constrained environments like containers or low-end VMs.
+By default, filesystem storage operates without encryption for optimal performance, providing fast uploads and downloads with minimal CPU overhead. This approach is ideal for most use cases where performance is prioritized.
 
-If performance is a priority and you don't need encryption (e.g., for non-sensitive data or testing), you can disable it by setting the environment variable `DISABLE_FILESYSTEM_ENCRYPTION=true` in your `.env` file or Docker configuration. Note that disabling encryption stores files in plaintext on disk, reducing security.
+If you need to protect sensitive files at rest, you can enable encryption by setting `DISABLE_FILESYSTEM_ENCRYPTION=false` and providing an `ENCRYPTION_KEY` in your configuration. When enabled, Palmr uses AES-256-CBC encryption, which adds CPU overhead during uploads (encryption) and downloads (decryption), particularly for large files or in resource-constrained environments like containers or low-end VMs.
 
 For optimal performance with encryption enabled, ensure your hardware supports AES-NI acceleration (check with `cat /proc/cpuinfo | grep aes` on Linux).
 

apps/docs/content/docs/3.1-beta/password-reset-without-smtp.mdx

@@ -47,12 +47,12 @@ docker exec -it <container_name_or_id> /bin/sh
 
 Replace `<container_name_or_id>` with the name or ID of your Palmr container. This command opens an interactive shell session inside the container, allowing you to execute commands directly.
 
-### 3. Navigate to the server directory
+### 3. Navigate to the application directory
 
-Once inside the container, navigate to the server directory where the reset script is located:
+Once inside the container, navigate to the application directory where the reset script is located:
 
 ```bash
-cd /app/server
+cd /app/palmr-app
 ```
 
 This directory contains the necessary scripts and configurations for managing Palmr's backend operations.
@@ -135,11 +135,11 @@ If you encounter issues while running the script, refer to the following solutio
   - Confirm that the `prisma/palmr.db` file exists and has the correct permissions.
   - Verify that the container has access to the database volume.
 
-- **Error: "Script must be run from server directory"**  
-  This error appears if you are not in the correct directory. Navigate to the server directory with:
+- **Error: "Script must be run from application directory"**  
+  This error appears if you are not in the correct directory. Navigate to the application directory with:
 
   ```bash
-  cd /app/server
+  cd /app/palmr-app
   ```
 
 - **Error: "User not found"**  

apps/docs/content/docs/3.1-beta/quick-start.mdx

@@ -3,224 +3,250 @@ title: Quick Start (Docker)
 icon: "Rocket"
 ---
 
+import { Callout } from "fumadocs-ui/components/callout";
+import { Tab, Tabs } from "fumadocs-ui/components/tabs";
+
+import { Card, CardGrid } from "@/components/ui/card";
+
 Welcome to the fastest way to deploy <span className="font-bold">Palmr.</span> - your secure, self-hosted file sharing solution. This guide will have you up and running in minutes, whether you're new to self-hosting or an experienced developer.
 
 Palmr. offers flexible deployment options to match your infrastructure needs. This guide focuses on Docker deployment with our recommended filesystem storage, perfect for most use cases.
 
 ## Prerequisites
 
-Ensure you have the following installed on your system:
+Before you begin, make sure you have:
 
 - **Docker** - Container runtime ([installation guide](https://docs.docker.com/get-docker/))
 - **Docker Compose** - Multi-container orchestration ([installation guide](https://docs.docker.com/compose/install/))
+- **2GB+ available disk space** for the application and your files
+- **Port 5487** available for the web interface
+- **Port 3333** available for API access (optional)
 
-> **Platform Support**: Palmr. is developed on macOS and extensively tested on Linux servers. While we haven't formally tested other platforms, Docker's cross-platform nature should ensure compatibility. Report any issues on our [GitHub repository](https://github.com/kyantech/Palmr/issues).
+<Callout>
+  **Platform Support**: Palmr. is developed on macOS and extensively tested on Linux servers. While we haven't formally
+  tested other platforms, Docker's cross-platform nature should ensure compatibility. Report any issues on our [GitHub
+  repository](https://github.com/kyantech/Palmr/issues).
+</Callout>
 
 ## Storage Options
 
 Palmr. supports two storage approaches for persistent data:
 
-### Named Volumes (Recommended)
+- **Named Volumes (Recommended)** - Docker-managed storage with optimal performance and no permission issues
+- **Bind Mounts** - Direct host filesystem access, ideal for development and direct file management
 
-**Best for**: Production environments, automated deployments
+## Deployment Options
 
-- ✅ **Managed by Docker**: No permission issues or manual path management
-- ✅ **Optimized Performance**: Docker-native storage optimization
-- ✅ **Cross-platform**: Consistent behavior across operating systems
-- ✅ **Simplified Backups**: Docker volume commands for backup/restore
+Choose your storage method based on your needs:
 
-### Bind Mounts
+<Tabs items={['Named Volumes (Recommended)', 'Bind Mounts']}>
+  <Tab value="Named Volumes (Recommended)">
+    Docker-managed storage that provides the best balance of performance, security, and ease of use:
 
-**Best for**: Development, direct file access requirements
+    - **No Permission Issues**: Docker handles all permission management automatically
+    - **Performance**: Optimized for container workloads with better I/O performance
+    - **Production Ready**: Recommended for production deployments
 
-- ✅ **Direct Access**: Files stored in local directory you specify
-- ✅ **Transparent Storage**: Direct filesystem access from host
-- ✅ **Custom Backup**: Use existing file system backup solutions
-- ⚠️ **Permission Considerations**: **Common Issue** - Requires UID/GID configuration (see troubleshooting below)
+    ### Configuration
 
----
+    Create a `docker-compose.yml` file:
 
-## Option 1: Named Volumes (Recommended)
+    ```yaml
+    services:
+      palmr:
+        image: kyantech/palmr:latest
+        container_name: palmr
+        restart: unless-stopped
+        ports:
+          - "5487:5487" # Web interface
+          # - "3333:3333" # API (optional)
+        environment:
+          # Optional: Uncomment and configure as needed (if you don`t use, you can remove)
+          # - ENABLE_S3=true # Set to true to enable S3-compatible storage
+          # - DISABLE_FILESYSTEM_ENCRYPTION=true # Set to false to enable file encryption
+          # - ENCRYPTION_KEY=your-secure-key-min-32-chars # Required only if encryption is enabled
+          # - PALMR_UID=1000 # UID for the container processes (default is 1000)
+          # - PALMR_GID=1000 # GID for the container processes (default is 1000)
+          # - SECURE_SITE=false # Set to true if you are using a reverse proxy
+          # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
+        volumes:
+          - palmr_data:/app/server
 
-Named volumes provide the best performance and are managed entirely by Docker.
-
-### Configuration
-
-Use the provided `docker-compose.yaml` for named volumes:
-
-```yaml
-services:
-  palmr:
-    image: kyantech/palmr:latest
-    container_name: palmr
-    environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=change-this-key-in-production-min-32-chars # CHANGE THIS KEY FOR SECURITY
-      # - DISABLE_FILESYSTEM_ENCRYPTION=false # Set to true to disable file encryption (ENCRYPTION_KEY becomes optional)
-      # - SECURE_SITE=false # Set to true if you are using a reverse proxy
-      # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
-    ports:
-      - "5487:5487" # Web interface
-      - "3333:3333" # API port (OPTIONAL EXPOSED - ONLY IF YOU WANT TO ACCESS THE API DIRECTLY)
     volumes:
-      - palmr_data:/app/server # Named volume for the application data
-    restart: unless-stopped # Restart the container unless it is stopped
+      palmr_data:
+    ```
 
-volumes:
-  palmr_data:
-```
+    <Callout type="info">
+      **Having upload or permission issues?** Add `PALMR_UID=1000` and `PALMR_GID=1000` to your environment variables. Check our [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) guide for more details.
+    </Callout>
 
-> **Note:** If you haveing problem with uploading files, try to change the `PALMR_UID` and `PALMR_GID` to the UID and GID of the user running the container. You can find the UID and GID of the user running the container with the command `id -u` and `id -g`. in Linux systems the default user is `1000` and the default group is `1000`. For test you can add the environment variables below to the `docker-compose.yaml` file and restart the container.
+    ### Deploy
 
-```yaml
-environment:
-  - PALMR_UID=1000 # UID for the container processes (default is 1001)
-  - PALMR_GID=1000 # GID for the container processes (default is 1001)
-```
+    ```bash
+    docker-compose up -d
+    ```
 
-> **Note:** For more information about UID and GID, see our [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) guide.
+  </Tab>
+  <Tab value="Bind Mounts">
+    Direct mapping to host filesystem directories, providing direct file access:
 
-### Deployment
+    - **Direct Access**: Files are directly accessible from your host system
+    - **Development Friendly**: Easy to inspect, modify, or backup files manually
+    - **Platform Dependent**: May require UID/GID configuration, especially on NAS systems
 
-```bash
-docker-compose up -d
-```
+    ### Configuration
 
----
+    Create a `docker-compose.yml` file:
 
-## Option 2: Bind Mounts
+    ```yaml
+    services:
+      palmr:
+        image: kyantech/palmr:latest
+        container_name: palmr
+        restart: unless-stopped
+        ports:
+          - "5487:5487" # Web interface
+          # - "3333:3333" # API (optional) 
+        environment:
+          # Optional: Uncomment and configure as needed (if you don`t use, you can remove)
+          # - ENABLE_S3=true # Set to true to enable S3-compatible storage
+          # - DISABLE_FILESYSTEM_ENCRYPTION=false # Set to false to enable file encryption
+          # - ENCRYPTION_KEY=your-secure-key-min-32-chars # Required only if encryption is enabled
+          # - PALMR_UID=1000 # UID for the container processes (default is 1000)
+          # - PALMR_GID=1000 # GID for the container processes (default is 1000)
+          # - SECURE_SITE=false # Set to true if you are using a reverse proxy
+          # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
+        volumes:
+          - ./data:/app/server
+    ```
 
-Bind mounts store data in a local directory, providing direct file system access.
+    <Callout type="info">
+      **Having upload or permission issues?** Add `PALMR_UID=1000` and `PALMR_GID=1000` to your environment variables. Check our [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) guide for more details.
+    </Callout>
 
-### Configuration
+    ### Deploy
 
-To use bind mounts, **replace the content** of your `docker-compose.yaml` with the following configuration (you can also reference `docker-compose-bind-mount-example.yaml` as a template):
+    ```bash
+    docker-compose up -d
+    ```
 
-```yaml
-services:
-  palmr:
-    image: kyantech/palmr:latest
-    container_name: palmr
-    environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=change-this-key-in-production-min-32-chars # CHANGE THIS KEY FOR SECURITY
-      - PALMR_UID=1000 # UID for the container processes (default is 1001)
-      - PALMR_GID=1000 # GID for the container processes (default is 1001)
-      # - DISABLE_FILESYSTEM_ENCRYPTION=false # Set to true to disable file encryption (ENCRYPTION_KEY becomes optional)
-      # - SECURE_SITE=false # Set to true if you are using a reverse proxy
-      # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
-    ports:
-      - "5487:5487" # Web port
-      - "3333:3333" # API port (OPTIONAL EXPOSED - ONLY IF YOU WANT TO ACCESS THE API DIRECTLY)
-    volumes:
-      # Bind mount for persistent data (uploads, database, temp files)
-      - ./data:/app/server # Local directory for the application data
-    restart: unless-stopped # Restart the container unless it is stopped
-```
+  </Tab>
+</Tabs>
 
-### Deployment
+## Configuration
 
-```bash
-docker-compose up -d
-```
+Customize Palmr's behavior with these environment variables:
 
-> **Permission Configuration**: If you encounter permission issues with bind mounts (common on NAS systems), see our [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) guide for automatic permission handling.
+| Variable                        | Default | Description                                                                                  |
+| ------------------------------- | ------- | -------------------------------------------------------------------------------------------- |
+| `ENABLE_S3`                     | `false` | Enable S3-compatible storage backends                                                        |
+| `ENCRYPTION_KEY`                | -       | **Required when encryption is enabled**: 32+ character key for file encryption               |
+| `DISABLE_FILESYSTEM_ENCRYPTION` | `true`  | Disable file encryption for better performance (set to `false` to enable encryption)         |
+| `SECURE_SITE`                   | `false` | Enable secure cookies for HTTPS/reverse proxy deployments                                    |
+| `DEFAULT_LANGUAGE`              | `en-US` | Default application language ([see available languages](/docs/3.1-beta/available-languages)) |
+| `PALMR_UID`                     | `1000`  | User ID for container processes (helps with file permissions)                                |
+| `PALMR_GID`                     | `1000`  | Group ID for container processes (helps with file permissions)                               |
 
----
+<Callout type="info">
+  **Performance First**: Palmr runs without encryption by default for optimal speed and lower resource usage—perfect for
+  most use cases.
+</Callout>
 
-## Environment Variables
+<Callout type="warn">
+  **Encryption Notice**: To enable encryption, set `DISABLE_FILESYSTEM_ENCRYPTION=false` and provide a 32+ character
+  `ENCRYPTION_KEY`. **Important**: This choice is permanent—switching encryption modes after uploading files will break
+  access to existing uploads.
+</Callout>
 
-Configure Palmr. behavior through environment variables:
+<Callout>
+  **Using a Reverse Proxy?** Set `SECURE_SITE=true` and check our [Reverse Proxy
+  Configuration](/docs/3.1-beta/reverse-proxy-configuration) guide for proper HTTPS setup.
+</Callout>
 
-| Variable                        | Default | Description                                                                                                       |
-| ------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
-| `ENABLE_S3`                     | `false` | Enable S3-compatible storage                                                                                      |
-| `ENCRYPTION_KEY`                | -       | **Required** (unless encryption disabled): Minimum 32 characters for file encryption                              |
-| `DISABLE_FILESYSTEM_ENCRYPTION` | `false` | Disable file encryption for direct filesystem access                                                              |
-| `SECURE_SITE`                   | `false` | Enable secure cookies for HTTPS/reverse proxy setups                                                              |
-| `DEFAULT_LANGUAGE`              | `en-US` | Set the default application language (see supported languages in docs [here](/docs/3.1-beta/available-languages)) |
-| `PALMR_UID`                     | `1001`  | Set the UID for the container processes (OPTIONAL - default is 1001)                                              |
-| `PALMR_GID`                     | `1001`  | Set the GID for the container processes (OPTIONAL - default is 1001)                                              |
+### Generate Encryption Keys (Optional)
 
-> **⚠️ Security Warning**: Always change the `ENCRYPTION_KEY` in production when encryption is enabled. This key encrypts your files - losing it makes files permanently inaccessible.
-
-> **🔓 File Encryption Control**: The `DISABLE_FILESYSTEM_ENCRYPTION` variable allows you to store files without encryption for direct filesystem access. When set to `true`, the `ENCRYPTION_KEY` becomes optional. **Important**: Once set, this configuration is permanent for your deployment. Switching between encrypted and unencrypted modes will break file access for existing uploads. Choose your strategy before uploading files. For more details on performance implications of encryption, see [Performance Considerations with Encryption](/docs/3.1-beta/architecture#performance-considerations-with-encryption).
-
-> **🔗 Reverse Proxy**: If deploying behind a reverse proxy (Traefik, Nginx, etc.), set `SECURE_SITE=true` and review our [Reverse Proxy Configuration](/docs/3.1-beta/reverse-proxy-configuration) guide for proper setup.
-
-### Generate Secure Encryption Keys
-
-Need a strong key for `ENCRYPTION_KEY`? Use our built-in generator to create cryptographically secure keys:
+Need file encryption? Generate a secure key:
 
 <KeyGenerator />
 
-> **💡 Pro Tip**: If you're using `DISABLE_FILESYSTEM_ENCRYPTION=true`, you can skip the `ENCRYPTION_KEY` entirely for a simpler setup. However, remember that files will be stored unencrypted on your filesystem.
+> **Pro Tip**: Only enable encryption if you're handling sensitive data. For most users, the default unencrypted mode provides better performance.
 
----
+## Access Your Instance
 
-## Accessing Palmr.
+Once deployed, open Palmr in your browser:
 
-Once deployed, access Palmr. through your web browser:
+- **Web Interface**: `http://localhost:5487` (local) or `http://YOUR_SERVER_IP:5487` (remote)
+- **API Documentation**: `http://localhost:3333/docs` (if port 3333 is exposed)
 
-- **Local**: `http://localhost:5487`
-- **Server**: `http://YOUR_SERVER_IP:5487`
+<Callout type="info">
+  **Learn More**: For complete API documentation, authentication, and integration examples, see our [API
+  Reference](/docs/3.1-beta/api) guide
+</Callout>
 
-### API Access (Optional)
-
-If you exposed port 3333 in your configuration, you can also access:
-
-- **API Documentation**: `http://localhost:3333/docs` (local) or `http://YOUR_SERVER_IP:3333/docs` (server)
-- **API Endpoints**: Available at `http://localhost:3333` (local) or `http://YOUR_SERVER_IP:3333` (server)
-
-> **📚 Learn More**: For complete API documentation, authentication, and integration examples, see our [API Reference](/docs/3.1-beta/api) guide.
-
-> **💡 Production Tip**: For production deployments, configure HTTPS with a valid SSL certificate for enhanced security.
+<Callout type="warn">
+  **Production Ready?** Configure HTTPS with a valid SSL certificate for secure production deployments.
+</Callout>
 
 ---
 
 ## Docker CLI Alternative
 
-Prefer using Docker directly? Both storage options are supported:
+Prefer Docker commands over Compose? Here are the equivalent commands:
 
-**Named Volume:**
+<Tabs items={["Named Volume", "Bind Mount"]}>
+  <Tab value="Named Volume">
 
-```bash
-docker run -d \
-  --name palmr \
-  -e ENABLE_S3=false \
-  -e ENCRYPTION_KEY=your-secure-key-min-32-chars \
-  # -e PALMR_UID=1000 # UID for the container processes (default is 1001)
-  # -e PALMR_GID=1000 # GID for the container processes (default is 1001)
-  # -e DISABLE_FILESYSTEM_ENCRYPTION=true # Uncomment to disable file encryption (ENCRYPTION_KEY becomes optional)
-  # -e SECURE_SITE=false # Set to true if you are using a reverse proxy
-  # -e DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
-  -p 5487:5487 \
-  -p 3333:3333 \
-  -v palmr_data:/app/server \
-  --restart unless-stopped \
-  kyantech/palmr:latest
-```
+    ```bash
+    docker run -d \
+      --name palmr \
+      # Optional: Uncomment and configure as needed (if you don`t use, you can remove)
+      # -e ENABLE_S3=true \ # Set to true to enable S3-compatible storage (OPTIONAL - default is false)
+      # -e DISABLE_FILESYSTEM_ENCRYPTION=false \ # Set to false to enable file encryption (ENCRYPTION_KEY becomes required) | (OPTIONAL - default is true)
+      # -e ENCRYPTION_KEY=your-secure-key-min-32-chars # Required only if encryption is enabled
+      # -e PALMR_UID=1000 # UID for the container processes (default is 1000)
+      # -e PALMR_GID=1000 # GID for the container processes (default is 1000)
+      # -e SECURE_SITE=false # Set to true if you are using a reverse proxy
+      # -e DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
+      -p 5487:5487 \
+      -p 3333:3333 \
+      -v palmr_data:/app/server \
+      --restart unless-stopped \
+      kyantech/palmr:latest
+    ```
 
-> **Permission Configuration**: If you encounter permission issues with bind mounts (common on NAS systems), see our [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) guide for automatic permission handling.
 
-**Bind Mount:**
+    <Callout type="info">
+      **Permission Issues?** Add `-e PALMR_UID=1000 -e PALMR_GID=1000` to the command above. See our [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) guide for details.
+    </Callout>
 
-```bash
-docker run -d \
-  --name palmr \
-  -e ENABLE_S3=false \
-  -e ENCRYPTION_KEY=your-secure-key-min-32-chars \
-  -e PALMR_UID=1000 # UID for the container processes (default is 1001)
-  -e PALMR_GID=1000 # GID for the container processes (default is 1001)
-  # -e DISABLE_FILESYSTEM_ENCRYPTION=true # Uncomment to disable file encryption (ENCRYPTION_KEY becomes optional)
-  # -e SECURE_SITE=false # Set to true if you are using a reverse proxy
-  # -e DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
-  -p 5487:5487 \
-  -p 3333:3333 \
-  -v $(pwd)/data:/app/server \
-  --restart unless-stopped \
-  kyantech/palmr:latest
-```
+  </Tab>
+
+  <Tab value="Bind Mount">
+
+    ```bash
+    docker run -d \
+      --name palmr \
+      # Optional: Uncomment and configure as needed (if you don`t use, you can remove)
+      # -e ENABLE_S3=true \ # Set to true to enable S3-compatible storage (OPTIONAL - default is false)
+      # -e DISABLE_FILESYSTEM_ENCRYPTION=true \ # Set to false to enable file encryption (ENCRYPTION_KEY becomes required) | (OPTIONAL - default is true)
+      # -e ENCRYPTION_KEY=your-secure-key-min-32-chars # Required only if encryption is enabled
+      # -e PALMR_UID=1000 # UID for the container processes (default is 1000)
+      # -e PALMR_GID=1000 # GID for the container processes (default is 1000)
+      # -e SECURE_SITE=false # Set to true if you are using a reverse proxy
+      # -e DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US)
+      -p 5487:5487 \
+      -p 3333:3333 \
+      -v $(pwd)/data:/app/server \
+      --restart unless-stopped \
+      kyantech/palmr:latest
+    ```
+
+    <Callout type="info">
+      **Permission Issues?** Add `-e PALMR_UID=1000 -e PALMR_GID=1000` to the command above. See our [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) guide for details.
+    </Callout>
+
+  </Tab>
+</Tabs>
 
 ---
 
@@ -228,52 +254,50 @@ docker run -d \
 
 ### Updates
 
-Keep Palmr. current with the latest features and security fixes:
+Keep Palmr up to date with the latest features and security patches:
 
 ```bash
 docker-compose pull
 docker-compose up -d
 ```
 
-### Backup & Restore
+### Backup Your Data
 
-The backup method depends on which storage option you're using:
-
-**Named Volume Backup:**
+**Named Volumes:**
 
 ```bash
-docker run --rm \
-  -v palmr_data:/data \
-  -v $(pwd):/backup \
-  alpine tar czf /backup/palmr-backup.tar.gz -C /data .
+docker run --rm -v palmr_data:/data -v $(pwd):/backup alpine tar czf /backup/palmr-backup.tar.gz -C /data .
 ```
 
-**Named Volume Restore:**
-
-```bash
-docker run --rm \
-  -v palmr_data:/data \
-  -v $(pwd):/backup \
-  alpine tar xzf /backup/palmr-backup.tar.gz -C /data
-```
-
-**Bind Mount Backup:**
+**Bind Mounts:**
 
 ```bash
 tar czf palmr-backup.tar.gz ./data
 ```
 
-**Bind Mount Restore:**
+### Restore From Backup
+
+**Named Volumes:**
 
 ```bash
+docker-compose down
+docker run --rm -v palmr_data:/data -v $(pwd):/backup alpine tar xzf /backup/palmr-backup.tar.gz -C /data
+docker-compose up -d
+```
+
+**Bind Mounts:**
+
+```bash
+docker-compose down
 tar xzf palmr-backup.tar.gz
+docker-compose up -d
 ```
 
 ---
 
-## Next Steps
+## What's Next?
 
-Your Palmr. instance is now ready! Explore additional configuration options:
+Your Palmr instance is ready! Here's what you can explore:
 
 ### Advanced Configuration
 
@@ -284,8 +308,11 @@ Your Palmr. instance is now ready! Explore additional configuration options:
 ### Integration & Development
 
 - **[API Reference](/docs/3.1-beta/api)** - Integrate Palmr. with your applications
-- **[Architecture Guide](/docs/3.1-beta/architecture)** - Understanding Palmr. components and design
+
+<Callout type="info">
+  **Need help?** Check our [Troubleshooting Guide](/docs/3.1-beta/troubleshooting) for common issues and solutions.
+</Callout>
 
 ---
 
-Need help? Visit our [GitHub Issues](https://github.com/kyantech/Palmr/issues) or community discussions.
+**Questions?** Visit our [GitHub Issues](https://github.com/kyantech/Palmr/issues) or join the community discussions.

apps/docs/content/docs/3.1-beta/reverse-proxy-configuration.mdx

@@ -127,7 +127,8 @@ proxy_pass_header Set-Cookie;
 environment:
   - PALMR_UID=1000 # Your host UID (check with: id)
   - PALMR_GID=1000 # Your host GID
-  - ENCRYPTION_KEY=your-key-here
+  - DISABLE_FILESYSTEM_ENCRYPTION=true # Set to false to enable file encryption
+  # - ENCRYPTION_KEY=your-key-here # Required only if encryption is enabled
 ```
 
 > **💡 Note**: Check your host UID/GID with `id` command and use those values. See [UID/GID Configuration](/docs/3.1-beta/uid-gid-configuration) for detailed setup.

apps/docs/content/docs/3.1-beta/troubleshooting.mdx

@@ -17,7 +17,7 @@ docker-compose logs palmr | grep -i "permission\|denied\|eacces"
 
 # Common error messages:
 # EACCES: permission denied, open '/app/server/uploads/file.txt'
-# Error: EACCES: permission denied, mkdir '/app/server/temp-chunks'
+# Error: EACCES: permission denied, mkdir '/app/server/temp-uploads'
 ```
 
 ### The Root Cause
@@ -25,7 +25,7 @@ docker-compose logs palmr | grep -i "permission\|denied\|eacces"
 **Palmr. defaults**: UID 1001, GID 1001  
 **Linux standard**: UID 1000, GID 1000
 
-When using bind mounts, your host directories are owned by UID 1000, but Palmr. runs as UID 1001.
+When using bind mounts, your host directories may have different ownership than Palmr's default UID/GID.
 
 ### Solution 1: Environment Variables (Recommended)
 
@@ -63,8 +63,8 @@ If you prefer to keep Palmr's defaults:
 chown -R 1001:1001 ./data
 
 # For separate upload/temp directories
-mkdir -p uploads temp-chunks
-chown -R 1001:1001 uploads temp-chunks
+mkdir -p uploads temp-uploads
+chown -R 1001:1001 uploads temp-uploads
 ```
 
 ### Solution 3: Docker Volume (Avoid the Issue)
@@ -109,16 +109,19 @@ docker-compose logs palmr
 2. **Invalid encryption key**
 
    ```bash
-   # Error: Encryption key must be at least 32 characters
-   # Fix: Update ENCRYPTION_KEY in docker-compose.yaml
+   # Error: Encryption key must be at least 32 characters (only if encryption is enabled)
+   # Fix: Either disable encryption or provide a valid key
    environment:
-     - ENCRYPTION_KEY=your-very-long-secure-key-at-least-32-characters
+     - DISABLE_FILESYSTEM_ENCRYPTION=true  # Disable encryption (default)
+     # OR enable encryption with:
+     # - DISABLE_FILESYSTEM_ENCRYPTION=false
+     # - ENCRYPTION_KEY=your-very-long-secure-key-at-least-32-characters
    ```
 
 3. **Missing environment variables**
    ```bash
-   # Check required variables are set
-   docker exec palmr env | grep -E "ENCRYPTION_KEY|DATABASE_URL"
+   # Check variables are set (encryption is optional)
+   docker exec palmr env | grep -E "DISABLE_FILESYSTEM_ENCRYPTION|ENCRYPTION_KEY|DATABASE_URL"
    ```
 
 ### Container Starts But App Doesn't Load
@@ -151,7 +154,7 @@ curl http://localhost:3333/health
 
    ```bash
    docker exec palmr ls -la /app/server/uploads/
-   # Should show ownership by palmr user
+   # Should show ownership by palmr user (UID 1001)
    ```
 
 3. **Check upload limits:**
@@ -178,13 +181,13 @@ docker exec palmr stat /app/server/uploads/your-file.txt
 
    ```bash
    # Using the built-in reset script
-   docker exec -it palmr /app/reset-password.sh
+   docker exec -it palmr /app/palmr-app/reset-password.sh
    ```
 
 2. **Check database permissions:**
    ```bash
    docker exec palmr ls -la /app/server/prisma/
-   # palmr.db should be writable by palmr user
+   # palmr.db should be writable by palmr user (UID 1001)
    ```
 
 ### OIDC Authentication Not Working
@@ -243,8 +246,8 @@ docker exec palmr ls -la /app/server/prisma/palmr.db
 # Check database logs
 docker-compose logs palmr | grep -i database
 
-# Verify Prisma schema
-docker exec palmr npx prisma db push --schema=./prisma/schema.prisma
+# Verify Prisma schema (run from palmr-app directory)
+docker exec palmr sh -c "cd /app/palmr-app && npx prisma db push"
 ```
 
 ### Database Corruption
@@ -283,7 +286,7 @@ docker-compose up -d
 
 3. **Check temp directory permissions:**
    ```bash
-   docker exec palmr ls -la /app/server/temp-chunks/
+   docker exec palmr ls -la /app/server/temp-uploads/
    ```
 
 ### High Memory Usage
@@ -318,16 +321,19 @@ docker port palmr
 echo "4. File Permissions:"
 docker exec palmr ls -la /app/server/
 
-echo "5. Environment Variables:"
-docker exec palmr env | grep -E "PALMR_|ENCRYPTION_|DATABASE_"
+echo "5. Application Files:"
+docker exec palmr ls -la /app/palmr-app/
 
-echo "6. API Health:"
+echo "6. Environment Variables:"
+docker exec palmr env | grep -E "PALMR_|DISABLE_FILESYSTEM_ENCRYPTION|ENCRYPTION_|DATABASE_"
+
+echo "7. API Health:"
 curl -s http://localhost:3333/health || echo "API not accessible"
 
-echo "7. Web Interface:"
+echo "8. Web Interface:"
 curl -s -o /dev/null -w "%{http_code}" http://localhost:5487 || echo "Web interface not accessible"
 
-echo "8. Disk Space:"
+echo "9. Disk Space:"
 df -h
 
 echo "=== End Health Check ==="

apps/docs/content/docs/3.1-beta/uid-gid-configuration.mdx

@@ -9,15 +9,15 @@ Configure user and group permissions for seamless bind mount compatibility acros
 
 Palmr. supports runtime UID/GID configuration to resolve permission conflicts when using bind mounts. This eliminates the need for manual permission management on your host system.
 
-**⚠️ Important**: Palmr uses **UID 1001, GID 1001** by default, which is different from the standard Linux convention of **UID 1000, GID 1000**. This is the most common cause of permission issues with bind mounts.
+**⚠️ Important**: Palmr uses **UID 1000, GID 1000** by default, which matches the standard Linux convention. However, some systems may use different UID/GID values, which can cause permission issues with bind mounts.
 
 ## The Permission Problem
 
 ### Why This Happens
 
-- **Palmr Default**: UID 1001, GID 1001 (container)
+- **Palmr Default**: UID 1000, GID 1000 (container)
 - **Linux Standard**: UID 1000, GID 1000 (most host systems)
-- **Result**: Container can't write to host directories
+- **Result**: Usually compatible, but some systems may use different values
 
 ### Common Error Scenarios
 
@@ -30,7 +30,7 @@ EACCES: permission denied, open '/app/server/uploads/file.txt'
 # Or when checking permissions:
 $ ls -la uploads/
 drwxr-xr-x 2 user user 4096 Jan 15 10:00 uploads/
-# Container tries to write as UID 1001, but directory is owned by UID 1000
+# Container tries to write with different UID/GID than directory owner
 ```
 
 ## Quick Fix
@@ -45,15 +45,13 @@ services:
     image: kyantech/palmr:latest
     container_name: palmr
     environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=your-secure-key-min-32-chars
       - PALMR_UID=1000
       - PALMR_GID=1000
     ports:
       - "5487:5487"
     volumes:
       - ./uploads:/app/server/uploads:rw
-      - ./temp-chunks:/app/server/temp-chunks:rw
+      - ./temp-uploads:/app/server/temp-uploads:rw
     restart: unless-stopped
 ```
 
@@ -63,8 +61,8 @@ If you prefer to keep Palmr's defaults:
 
 ```bash
 # Create directories with correct ownership
-mkdir -p uploads temp-chunks
-chown -R 1001:1001 uploads temp-chunks
+mkdir -p uploads temp-uploads
+chown -R 1001:1001 uploads temp-uploads
 ```
 
 ## Environment Variables
@@ -104,8 +102,6 @@ services:
     image: kyantech/palmr:latest
     container_name: palmr
     environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=your-secure-key-min-32-chars
       - PALMR_UID=1000
       - PALMR_GID=1000
     ports:
@@ -123,8 +119,6 @@ services:
     image: kyantech/palmr:latest
     container_name: palmr
     environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=your-secure-key-min-32-chars
       - PALMR_UID=1026
       - PALMR_GID=100
     ports:
@@ -142,8 +136,6 @@ services:
     image: kyantech/palmr:latest
     container_name: palmr
     environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=your-secure-key-min-32-chars
       - PALMR_UID=1000
       - PALMR_GID=100
     ports:
@@ -166,7 +158,7 @@ services:
 id
 
 # 2. Check directory ownership
-ls -la uploads/ temp-chunks/
+ls -la uploads/ temp-uploads/
 
 # 3. Fix via environment variables (preferred)
 # Add to docker-compose.yaml:
@@ -174,7 +166,7 @@ ls -la uploads/ temp-chunks/
 # - PALMR_GID=1000
 
 # 4. Or fix via chown (alternative)
-chown -R 1001:1001 uploads temp-chunks
+chown -R 1001:1001 uploads temp-uploads
 ```
 
 **Error**: Container starts but files aren't accessible
@@ -225,11 +217,11 @@ cat /etc/passwd | grep -v nobody
 ```bash
 # Check if directories exist and are writable
 test -w uploads && echo "uploads writable" || echo "uploads NOT writable"
-test -w temp-chunks && echo "temp-chunks writable" || echo "temp-chunks NOT writable"
+test -w temp-uploads && echo "temp-uploads writable" || echo "temp-uploads NOT writable"
 
 # Create directories with correct permissions
-mkdir -p uploads temp-chunks
-sudo chown -R $(id -u):$(id -g) uploads temp-chunks
+mkdir -p uploads temp-uploads
+sudo chown -R $(id -u):$(id -g) uploads temp-uploads
 ```
 
 ---
@@ -270,7 +262,7 @@ To add UID/GID configuration to running installations:
    cp -r ./data ./data-backup
    # or
    cp -r ./uploads ./uploads-backup
-   cp -r ./temp-chunks ./temp-chunks-backup
+   cp -r ./temp-uploads ./temp-uploads-backup
    ```
 
 3. **Check your UID/GID**
@@ -344,4 +336,4 @@ For most users experiencing permission issues with bind mounts:
    ```
 3. **Restart**: `docker-compose down && docker-compose up -d`
 
-This resolves the mismatch between Palmr's default UID 1001 and the standard Linux UID 1000.
+This ensures compatibility between Palmr's UID/GID and your host system's file ownership.

apps/docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmr-docs",
-  "version": "3.1.5-beta",
+  "version": "3.1.7-beta",
   "description": "Docs for Palmr",
   "private": true,
   "author": "Daniel Luiz Alves <daniel@kyantech.com.br>",

apps/docs/src/components/ui/card.tsx

@@ -5,14 +5,15 @@ import { cn } from "@/lib/utils";
 
 interface CardProps {
   title: string;
-  description: string;
+  description?: string;
   href?: string;
   icon?: ReactNode;
   className?: string;
   onClick?: () => void;
+  children?: ReactNode;
 }
 
-export const Card = ({ title, description, href, icon, className, onClick }: CardProps) => {
+export const Card = ({ title, description, href, icon, className, onClick, children }: CardProps) => {
   const cardContent = (
     <div
       className={cn(
@@ -37,9 +38,16 @@ export const Card = ({ title, description, href, icon, className, onClick }: Car
           <h3 className="font-medium text-sm text-foreground mb-1 group-hover:text-primary transition-colors duration-200 mt-3 text-decoration-none">
             {title}
           </h3>
-          <p className="text-xs text-muted-foreground/80 leading-relaxed line-clamp-2 group-hover:text-muted-foreground transition-colors duration-200">
-            {description}
-          </p>
+          {description && (
+            <p className="text-xs text-muted-foreground/80 leading-relaxed line-clamp-2 group-hover:text-muted-foreground transition-colors duration-200">
+              {description}
+            </p>
+          )}
+          {children && (
+            <div className="text-xs text-muted-foreground/80 leading-relaxed group-hover:text-muted-foreground transition-colors duration-200 mt-2">
+              {children}
+            </div>
+          )}
         </div>
         <div className="flex-shrink-0 ml-2">
           <div className="w-5 h-5 rounded-full bg-muted/40 flex items-center justify-center opacity-0 group-hover:opacity-100 group-hover:bg-primary/10 transition-all duration-200">

apps/server/.env.example

@@ -1,6 +1,7 @@
 # FOR FILESYSTEM STORAGE ENV VARS
 ENABLE_S3=false 
-ENCRYPTION_KEY=change-this-key-in-production-min-32-chars
+DISABLE_FILESYSTEM_ENCRYPTION=true
+# ENCRYPTION_KEY=change-this-key-in-production-min-32-chars # Required only if encryption is enabled (DISABLE_FILESYSTEM_ENCRYPTION=false)
 DATABASE_URL="file:./palmr.db"
 
 # FOR USE WITH S3 COMPATIBLE STORAGE

apps/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmr-api",
-  "version": "3.1.5-beta",
+  "version": "3.1.7-beta",
   "description": "API for Palmr",
   "private": true,
   "author": "Daniel Luiz Alves <daniel@kyantech.com.br>",

apps/server/reset-password.sh

@@ -6,7 +6,7 @@
 echo "🔐 Palmr Password Reset Tool"
 echo "============================="
 
-# Check if we're in the right directory
+# Check if we're in the right directory and set DATABASE_URL
 if [ ! -f "package.json" ]; then
     echo "❌ Error: This script must be run from the server directory (/app/server)"
     echo "   Current directory: $(pwd)"
@@ -14,18 +14,26 @@ if [ ! -f "package.json" ]; then
     exit 1
 fi
 
+# Set DATABASE_URL if not already set
+if [ -z "$DATABASE_URL" ]; then
+    export DATABASE_URL="file:/app/server/prisma/palmr.db"
+fi
+
+# Ensure database directory exists
+mkdir -p /app/server/prisma
+
 # Function to check if tsx is available
 check_tsx() {
     # Check if tsx binary exists in node_modules
     if [ -f "node_modules/.bin/tsx" ]; then
         return 0
     fi
-    
+
     # Fallback: try npx
     if npx tsx --version >/dev/null 2>&1; then
         return 0
     fi
-    
+
     return 1
 }
 
@@ -39,7 +47,7 @@ install_tsx_only() {
     else
         return 1
     fi
-    
+
     return $?
 }
 
@@ -62,7 +70,7 @@ ensure_prisma() {
     if [ -d "node_modules/@prisma/client" ] && [ -f "node_modules/@prisma/client/index.js" ]; then
         return 0
     fi
-    
+
     echo "📦 Generating Prisma client..."
     if npx prisma generate --silent >/dev/null 2>&1; then
         echo "✅ Prisma client ready"
@@ -81,14 +89,14 @@ if check_tsx; then
     echo "✅ tsx is ready"
 else
     echo "📦 tsx not found, installing..."
-    
+
     # Try quick tsx-only install first
     if install_tsx_only && check_tsx; then
         echo "✅ tsx installed successfully"
     else
         echo "⚠️  Quick install failed, installing all dependencies..."
         install_all_deps
-        
+
         # Final check
         if ! check_tsx; then
             echo "❌ Error: tsx is still not available after full installation"
@@ -119,4 +127,4 @@ if [ -f "node_modules/.bin/tsx" ]; then
     node_modules/.bin/tsx src/scripts/reset-password.ts "$@"
 else
     npx tsx src/scripts/reset-password.ts "$@"
-fi 
+fi

apps/server/src/env.ts

@@ -2,8 +2,8 @@ import { z } from "zod";
 
 const envSchema = z.object({
   ENABLE_S3: z.union([z.literal("true"), z.literal("false")]).default("false"),
-  ENCRYPTION_KEY: z.string().optional().default("palmr-default-encryption-key-2025"),
-  DISABLE_FILESYSTEM_ENCRYPTION: z.union([z.literal("true"), z.literal("false")]).default("false"),
+  ENCRYPTION_KEY: z.string().optional(),
+  DISABLE_FILESYSTEM_ENCRYPTION: z.union([z.literal("true"), z.literal("false")]).default("true"),
   S3_ENDPOINT: z.string().optional(),
   S3_PORT: z.string().optional(),
   S3_USE_SSL: z.string().optional(),

apps/server/src/providers/filesystem-storage.provider.ts

@@ -20,6 +20,13 @@ export class FilesystemStorageProvider implements StorageProvider {
   private constructor() {
     this.uploadsDir = directoriesConfig.uploads;
 
+    if (!this.isEncryptionDisabled && !this.encryptionKey) {
+      throw new Error(
+        "Encryption is enabled but ENCRYPTION_KEY is not provided. " +
+          "Please set ENCRYPTION_KEY environment variable or set DISABLE_FILESYSTEM_ENCRYPTION=true to disable encryption."
+      );
+    }
+
     this.ensureUploadsDir();
     setInterval(() => this.cleanExpiredTokens(), 5 * 60 * 1000);
     setInterval(() => this.cleanupEmptyTempDirs(), 10 * 60 * 1000);
@@ -62,6 +69,11 @@ export class FilesystemStorageProvider implements StorageProvider {
   }
 
   private createEncryptionKey(): Buffer {
+    if (!this.encryptionKey) {
+      throw new Error(
+        "Encryption key is required when encryption is enabled. Please set ENCRYPTION_KEY environment variable."
+      );
+    }
     return crypto.scryptSync(this.encryptionKey, "salt", 32);
   }
 
@@ -441,6 +453,11 @@ export class FilesystemStorageProvider implements StorageProvider {
   }
 
   private decryptFileLegacy(encryptedBuffer: Buffer): Buffer {
+    if (!this.encryptionKey) {
+      throw new Error(
+        "Encryption key is required when encryption is enabled. Please set ENCRYPTION_KEY environment variable."
+      );
+    }
     const CryptoJS = require("crypto-js");
     const decrypted = CryptoJS.AES.decrypt(encryptedBuffer.toString("utf8"), this.encryptionKey);
     return Buffer.from(decrypted.toString(CryptoJS.enc.Utf8), "base64");

apps/web/messages/ar-SA.json

@@ -159,7 +159,8 @@
     "passwordLabel": "كلمة المرور",
     "create": "إنشاء مشاركة",
     "success": "تم إنشاء المشاركة بنجاح",
-    "error": "فشل في إنشاء المشاركة"
+    "error": "فشل في إنشاء المشاركة",
+    "namePlaceholder": "أدخل اسمًا لمشاركتك"
   },
   "dashboard": {
     "loadError": "فشل في تحميل بيانات لوحة التحكم",
@@ -1659,7 +1660,8 @@
       "title": "إفلات الملفات للرفع",
       "description": "حرر للرفع ملفاتك"
     },
-    "pasteSuccess": "{count, plural, =1 {تم لصق الصورة ورفعها بنجاح} other {تم لصق # صور ورفعها بنجاح}}"
+    "pasteSuccess": "{count, plural, =1 {تم لصق الصورة ورفعها بنجاح} other {تم لصق # صور ورفعها بنجاح}}",
+    "filesQueued": "{count, plural, one {# ملف في الصف} other {# ملفات في الصف}}"
   },
   "users": {
     "modes": {

apps/web/messages/de-DE.json

@@ -159,7 +159,8 @@
     "passwordLabel": "Passwort",
     "create": "Freigabe Erstellen",
     "success": "Freigabe erfolgreich erstellt",
-    "error": "Fehler beim Erstellen der Freigabe"
+    "error": "Fehler beim Erstellen der Freigabe",
+    "namePlaceholder": "Geben Sie einen Namen für Ihre Freigabe ein"
   },
   "dashboard": {
     "loadError": "Fehler beim Laden der Dashboard-Daten",
@@ -1657,7 +1658,8 @@
       "title": "Dateien zum Hochladen ablegen",
       "description": "Loslassen, um Ihre Dateien hochzuladen"
     },
-    "pasteSuccess": "{count, plural, =1 {Bild erfolgreich eingefügt und hochgeladen} other {# Bilder erfolgreich eingefügt und hochgeladen}}"
+    "pasteSuccess": "{count, plural, =1 {Bild erfolgreich eingefügt und hochgeladen} other {# Bilder erfolgreich eingefügt und hochgeladen}}",
+    "filesQueued": "{count, plural, one {# Datei in der Warteschlange} other {# Dateien in der Warteschlange}}"
   },
   "users": {
     "modes": {

apps/web/messages/en-US.json

@@ -149,6 +149,7 @@
   "createShare": {
     "title": "Create Share",
     "nameLabel": "Share Name",
+    "namePlaceholder": "Enter a name for your share",
     "descriptionLabel": "Description",
     "descriptionPlaceholder": "Enter a description (optional)",
     "expirationLabel": "Expiration Date",
@@ -1634,6 +1635,7 @@
     "selectFile": "Click to select a file",
     "selectMultipleFiles": "Click to select one or multiple files",
     "dragAndDrop": "or drag and drop files here",
+    "filesQueued": "{count, plural, one {# file queued for upload} other {# files queued for upload}}",
     "preview": "Preview",
     "uploadProgress": "Upload progress",
     "upload": "Upload",
@@ -1745,4 +1747,4 @@
     "nameRequired": "Name is required",
     "required": "This field is required"
   }
-}
+}

apps/web/messages/es-ES.json

@@ -159,7 +159,8 @@
     "passwordLabel": "Contraseña",
     "create": "Crear Compartir",
     "success": "Compartir creado exitosamente",
-    "error": "Error al crear compartir"
+    "error": "Error al crear compartir",
+    "namePlaceholder": "Ingrese un nombre para su compartir"
   },
   "dashboard": {
     "loadError": "Error al cargar los datos del tablero",
@@ -1657,7 +1658,8 @@
       "title": "Suelta archivos para subir",
       "description": "Suelta para subir tus archivos"
     },
-    "pasteSuccess": "{count, plural, =1 {Imagen pegada y subida exitosamente} other {# imágenes pegadas y subidas exitosamente}}"
+    "pasteSuccess": "{count, plural, =1 {Imagen pegada y subida exitosamente} other {# imágenes pegadas y subidas exitosamente}}",
+    "filesQueued": "{count, plural, one {# archivo en cola para subir} other {# archivos en cola para subir}}"
   },
   "users": {
     "modes": {

apps/web/messages/fr-FR.json

@@ -159,7 +159,8 @@
     "passwordLabel": "Mot de Passe",
     "create": "Créer un Partage",
     "success": "Partage créé avec succès",
-    "error": "Échec de la création du partage"
+    "error": "Échec de la création du partage",
+    "namePlaceholder": "Entrez un nom pour votre partage"
   },
   "dashboard": {
     "loadError": "Échec du chargement des données du tableau de bord",
@@ -1657,7 +1658,8 @@
       "title": "Déposer des fichiers pour télécharger",
       "description": "Relâchez pour télécharger vos fichiers"
     },
-    "pasteSuccess": "{count, plural, =1 {Image collée et téléchargée avec succès} other {# images collées et téléchargées avec succès}}"
+    "pasteSuccess": "{count, plural, =1 {Image collée et téléchargée avec succès} other {# images collées et téléchargées avec succès}}",
+    "filesQueued": "{count, plural, one {# fichier en attente de téléchargement} other {# fichiers en attente de téléchargement}}"
   },
   "users": {
     "modes": {

apps/web/messages/hi-IN.json

@@ -159,7 +159,8 @@
     "passwordLabel": "पासवर्ड",
     "create": "साझाकरण बनाएं",
     "success": "साझाकरण सफलतापूर्वक बनाया गया",
-    "error": "साझाकरण बनाने में विफल"
+    "error": "साझाकरण बनाने में विफल",
+    "namePlaceholder": "अपने साझाकरण के लिए एक नाम दर्ज करें"
   },
   "dashboard": {
     "loadError": "डैशबोर्ड डेटा लोड करने में त्रुटि",
@@ -1657,7 +1658,8 @@
       "title": "अपलोड करने के लिए फ़ाइलें छोड़ें",
       "description": "अपनी फ़ाइलें अपलोड करने के लिए छोड़ें"
     },
-    "pasteSuccess": "{count, plural, =1 {छवि सफलतापूर्वक चिपकाई और अपलोड की गई} other {# छवियाँ सफलतापूर्वक चिपकाई और अपलोड की गईं}}"
+    "pasteSuccess": "{count, plural, =1 {छवि सफलतापूर्वक चिपकाई और अपलोड की गई} other {# छवियाँ सफलतापूर्वक चिपकाई और अपलोड की गईं}}",
+    "filesQueued": "{count, plural, one {# फ़ाइल अपलोड के लिए इंतजार में है} other {# फ़ाइलें अपलोड के लिए इंतजार में हैं}}"
   },
   "users": {
     "modes": {

apps/web/messages/it-IT.json

@@ -159,7 +159,8 @@
     "passwordLabel": "Password",
     "create": "Crea Condivisione",
     "success": "Condivisione creata con successo",
-    "error": "Errore nella creazione della condivisione"
+    "error": "Errore nella creazione della condivisione",
+    "namePlaceholder": "Inserisci un nome per la tua condivisione"
   },
   "dashboard": {
     "loadError": "Errore durante il caricamento dei dati del pannello di controllo",
@@ -1657,7 +1658,8 @@
       "title": "Rilascia i file per caricarli",
       "description": "Rilascia per caricare i tuoi file"
     },
-    "pasteSuccess": "{count, plural, =1 {Immagine incollata e caricata con successo} other {# immagini incollate e caricate con successo}}"
+    "pasteSuccess": "{count, plural, =1 {Immagine incollata e caricata con successo} other {# immagini incollate e caricate con successo}}",
+    "filesQueued": "{count, plural, one {# file in coda per il caricamento} other {# files in coda per il caricamento}}"
   },
   "users": {
     "modes": {

apps/web/messages/ja-JP.json

@@ -159,7 +159,8 @@
     "passwordLabel": "パスワード",
     "create": "共有を作成",
     "success": "共有が正常に作成されました",
-    "error": "共有の作成に失敗しました"
+    "error": "共有の作成に失敗しました",
+    "namePlaceholder": "共有の名前を入力してください"
   },
   "dashboard": {
     "loadError": "ダッシュボードデータの読み込みに失敗しました",
@@ -1657,7 +1658,8 @@
       "title": "アップロードするファイルをドロップ",
       "description": "ファイルをアップロードするにはリリースしてください"
     },
-    "pasteSuccess": "{count, plural, =1 {画像が貼り付けられ、正常にアップロードされました} other {#個の画像が貼り付けられ、正常にアップロードされました}}"
+    "pasteSuccess": "{count, plural, =1 {画像が貼り付けられ、正常にアップロードされました} other {#個の画像が貼り付けられ、正常にアップロードされました}}",
+    "filesQueued": "{count, plural, one {# ファイルがアップロード待ち} other {# ファイルがアップロード待ち}}"
   },
   "users": {
     "modes": {

apps/web/messages/ko-KR.json

@@ -159,7 +159,8 @@
     "passwordLabel": "비밀번호",
     "create": "공유 생성",
     "success": "공유가 성공적으로 생성되었습니다",
-    "error": "공유 생성에 실패했습니다"
+    "error": "공유 생성에 실패했습니다",
+    "namePlaceholder": "공유 이름을 입력하세요"
   },
   "dashboard": {
     "loadError": "대시보드 데이터를 불러오는데 실패했습니다",
@@ -1657,7 +1658,8 @@
       "title": "업로드할 파일 드롭",
       "description": "파일을 업로드하려면 놓으세요"
     },
-    "pasteSuccess": "{count, plural, =1 {이미지가 성공적으로 붙여넣기 및 업로드되었습니다} other {# 개의 이미지가 성공적으로 붙여넣기 및 업로드되었습니다}}"
+    "pasteSuccess": "{count, plural, =1 {이미지가 성공적으로 붙여넣기 및 업로드되었습니다} other {# 개의 이미지가 성공적으로 붙여넣기 및 업로드되었습니다}}",
+    "filesQueued": "{count, plural, one {# 파일이 업로드 대기 중} other {# 파일이 업로드 대기 중}}"
   },
   "users": {
     "modes": {

apps/web/messages/nl-NL.json

@@ -159,7 +159,8 @@
     "passwordLabel": "Wachtwoord",
     "create": "Delen Maken",
     "success": "Delen succesvol aangemaakt",
-    "error": "Fout bij het aanmaken van delen"
+    "error": "Fout bij het aanmaken van delen",
+    "namePlaceholder": "Voer een naam in voor uw delen"
   },
   "dashboard": {
     "loadError": "Fout bij het laden van controlepaneel gegevens",
@@ -1657,7 +1658,8 @@
       "title": "Sleep bestanden om te uploaden",
       "description": "Laat los om je bestanden te uploaden"
     },
-    "pasteSuccess": "{count, plural, =1 {Afbeelding geplakt en succesvol geüpload} other {# afbeeldingen geplakt en succesvol geüpload}}"
+    "pasteSuccess": "{count, plural, =1 {Afbeelding geplakt en succesvol geüpload} other {# afbeeldingen geplakt en succesvol geüpload}}",
+    "filesQueued": "{count, plural, one {# bestand in de wachtrij voor upload} other {# bestanden in de wachtrij voor upload}}"
   },
   "users": {
     "modes": {

apps/web/messages/pl-PL.json

@@ -159,7 +159,8 @@
     "passwordLabel": "Hasło",
     "create": "Utwórz Udostępnienie",
     "success": "Udostępnienie utworzone pomyślnie",
-    "error": "Nie udało się utworzyć udostępnienia"
+    "error": "Nie udało się utworzyć udostępnienia",
+    "namePlaceholder": "Wprowadź nazwę dla swojego udostępnienia"
   },
   "dashboard": {
     "loadError": "Nie udało się załadować danych panelu głównego",
@@ -1657,7 +1658,8 @@
       "title": "Upuść pliki, aby przesłać",
       "description": "Zwolnij, aby przesłać pliki"
     },
-    "pasteSuccess": "{count, plural, =1 {Obraz wklejony i przesłany pomyślnie} other {# obrazy wklejone i przesłane pomyślnie}}"
+    "pasteSuccess": "{count, plural, =1 {Obraz wklejony i przesłany pomyślnie} other {# obrazy wklejone i przesłane pomyślnie}}",
+    "filesQueued": "{count, plural, one {# plik w kolejce do przesyłania} other {# pliki w kolejce do przesyłania}}"
   },
   "users": {
     "modes": {

apps/web/messages/pt-BR.json

@@ -159,7 +159,8 @@
     "passwordLabel": "Senha",
     "create": "Criar compartilhamento",
     "success": "Compartilhamento criado com sucesso",
-    "error": "Falha ao criar compartilhamento"
+    "error": "Falha ao criar compartilhamento",
+    "namePlaceholder": "Digite um nome para seu compartilhamento"
   },
   "dashboard": {
     "loadError": "Falha ao carregar dados do painel",
@@ -643,7 +644,7 @@
       "edit": "Editar",
       "delete": "Excluir",
       "viewFiles": "Arquivos Recebidos",
-      "viewQrCode": "[TO_TRANSLATE] View QR Code"
+      "viewQrCode": "Ver QR Code"
     },
     "empty": {
       "title": "Nenhum link de recebimento criado",
@@ -1657,7 +1658,8 @@
       "continue": "Continuar Uploads",
       "cancel": "Cancelar Uploads"
     },
-    "pasteSuccess": "{count, plural, =1 {Imagem colada e enviada com sucesso} other {# imagens coladas e enviadas com sucesso}}"
+    "pasteSuccess": "{count, plural, =1 {Imagem colada e enviada com sucesso} other {# imagens coladas e enviadas com sucesso}}",
+    "filesQueued": "{count, plural, one {# arquivo na fila para upload} other {# arquivos na fila para upload}}"
   },
   "users": {
     "modes": {

apps/web/messages/ru-RU.json

@@ -159,7 +159,8 @@
     "success": "Общий доступ успешно создан",
     "error": "Не удалось создать общий доступ",
     "descriptionLabel": "Описание",
-    "descriptionPlaceholder": "Введите описание (опционально)"
+    "descriptionPlaceholder": "Введите описание (опционально)",
+    "namePlaceholder": "Введите имя для вашего общего доступа"
   },
   "dashboard": {
     "loadError": "Ошибка загрузки данных панели управления",
@@ -1657,7 +1658,8 @@
       "title": "Перетащите файлы для загрузки",
       "description": "Отпустите, чтобы загрузить файлы"
     },
-    "pasteSuccess": "{count, plural, =1 {Изображение вставлено и успешно загружено} other {# изображений вставлено и успешно загружено}}"
+    "pasteSuccess": "{count, plural, =1 {Изображение вставлено и успешно загружено} other {# изображений вставлено и успешно загружено}}",
+    "filesQueued": "{count, plural, one {# файл в очереди для загрузки} other {# файлов в очереди для загрузки}}"
   },
   "users": {
     "modes": {

apps/web/messages/tr-TR.json

@@ -159,7 +159,8 @@
     "success": "Paylaşım başarıyla oluşturuldu",
     "error": "Paylaşım oluşturulamadı",
     "descriptionLabel": "Açıklama",
-    "descriptionPlaceholder": "Açıklama girin (isteğe bağlı)"
+    "descriptionPlaceholder": "Açıklama girin (isteğe bağlı)",
+    "namePlaceholder": "Paylaşımınız için bir ad girin"
   },
   "dashboard": {
     "loadError": "Gösterge paneli verileri yüklenemedi",
@@ -1657,7 +1658,8 @@
       "title": "Yüklemek için dosyaları bırakın",
       "description": "Dosyalarınızı yüklemek için bırakın"
     },
-    "pasteSuccess": "{count, plural, =1 {Görüntü yapıştırıldı ve başarıyla yüklendi} other {# görüntü yapıştırıldı ve başarıyla yüklendi}}"
+    "pasteSuccess": "{count, plural, =1 {Görüntü yapıştırıldı ve başarıyla yüklendi} other {# görüntü yapıştırıldı ve başarıyla yüklendi}}",
+    "filesQueued": "{count, plural, one {# dosya yükleme için bekliyor} other {# dosya yükleme için bekliyor}}"
   },
   "users": {
     "modes": {

apps/web/messages/zh-CN.json

@@ -159,7 +159,8 @@
     "passwordLabel": "密码",
     "create": "创建分享",
     "success": "分享创建成功",
-    "error": "创建分享失败"
+    "error": "创建分享失败",
+    "namePlaceholder": "输入分享名称"
   },
   "dashboard": {
     "loadError": "加载仪表盘数据失败",
@@ -1657,7 +1658,8 @@
       "title": "拖放文件以上传",
       "description": "松开以上传您的文件"
     },
-    "pasteSuccess": "{count, plural, =1 {图片已成功粘贴并上传} other {# 张图片已成功粘贴并上传}}"
+    "pasteSuccess": "{count, plural, =1 {图片已成功粘贴并上传} other {# 张图片已成功粘贴并上传}}",
+    "filesQueued": "{count, plural, one {# 文件正在等待上传} other {# 文件正在等待上传}}"
   },
   "users": {
     "modes": {

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmr-web",
-  "version": "3.1.5-beta",
+  "version": "3.1.7-beta",
   "description": "Frontend for Palmr",
   "private": true,
   "author": "Daniel Luiz Alves <daniel@kyantech.com.br>",

apps/web/src/app/(home)/components/navbar.tsx

@@ -29,7 +29,7 @@ export function Navbar() {
               {appLogo && <img alt="App Logo" className="h-8 w-8 object-contain rounded" src={appLogo} />}
               <p className="font-bold text-2xl">{appName}</p>
             </Link>
-            <nav className="hidden lg:flex ml-2 gap-4">
+            <nav className="hidden md:flex ml-2 gap-4">
               {siteConfig.navItems.map((item) => (
                 <Link
                   key={item.href}
@@ -44,7 +44,7 @@ export function Navbar() {
               ))}
             </nav>
           </div>
-          <div className="hidden md:flex items-center gap-2">
+          <div className="hidden lg:flex items-center gap-2">
             <LanguageSwitcher />
             <ModeToggle />
 
@@ -56,7 +56,7 @@ export function Navbar() {
             </Button>
           </div>
 
-          <div className="flex items-center gap-2 sm:hidden">
+          <div className="flex items-center gap-2 md:hidden">
             <LanguageSwitcher />
             <ModeToggle />
             <Sheet open={isMenuOpen} onOpenChange={setIsMenuOpen}>
@@ -79,6 +79,16 @@ export function Navbar() {
                         {item.label}
                       </Link>
                     ))}
+                    <Link
+                      href={siteConfig.links.sponsor}
+                      target="_blank"
+                      rel="noopener noreferrer"
+                      className="text-foreground text-lg font-medium flex items-center gap-2"
+                      onClick={() => setIsMenuOpen(false)}
+                    >
+                      <IconHeart className="h-4 w-4 text-destructive" />
+                      Sponsor
+                    </Link>
                   </div>
                 </div>
               </SheetContent>

apps/web/src/components/auth/protected-route.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useEffect, type ReactNode } from "react";
+import { useEffect, useState, type ReactNode } from "react";
 import { useRouter } from "next/navigation";
 
 import { useAuth } from "@/contexts/auth-context";
@@ -14,16 +14,21 @@ type ProtectedRouteProps = {
 export function ProtectedRoute({ children, requireAdmin = false }: ProtectedRouteProps) {
   const { isAuthenticated, isAdmin } = useAuth();
   const router = useRouter();
+  const [hasCheckedAuth, setHasCheckedAuth] = useState(false);
 
   useEffect(() => {
-    if (isAuthenticated === false) {
-      router.replace("/login");
-    } else if (requireAdmin && isAdmin === false) {
-      router.replace("/dashboard");
+    if (isAuthenticated !== null) {
+      setHasCheckedAuth(true);
+
+      if (isAuthenticated === false) {
+        router.replace("/login");
+      } else if (requireAdmin && isAdmin === false) {
+        router.replace("/dashboard");
+      }
     }
   }, [isAuthenticated, isAdmin, requireAdmin, router]);
 
-  if (isAuthenticated === null || (requireAdmin && isAdmin === null)) {
+  if (!hasCheckedAuth || isAuthenticated === null || (requireAdmin && isAdmin === null)) {
     return <LoadingScreen />;
   }
 

apps/web/src/components/layout/navbar.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import { useState } from "react";
 import Link from "next/link";
 import { useRouter } from "next/navigation";
 import { IconLogout, IconSettings, IconUser, IconUsers } from "@tabler/icons-react";
@@ -21,8 +22,22 @@ import { logout as logoutAPI } from "@/http/endpoints";
 export function Navbar() {
   const t = useTranslations();
   const router = useRouter();
-  const { user, isAdmin, logout } = useAuth();
+  const { user, isAdmin, logout, isAuthenticated } = useAuth();
   const { appName, appLogo } = useAppInfo();
+  const [isNavigating, setIsNavigating] = useState(false);
+
+  const handleLogoClick = async () => {
+    if (isNavigating || !isAuthenticated) return;
+
+    try {
+      setIsNavigating(true);
+      router.replace("/dashboard");
+    } catch (err) {
+      console.error("Error navigating to dashboard:", err);
+    } finally {
+      setTimeout(() => setIsNavigating(false), 500);
+    }
+  };
 
   const handleLogout = async () => {
     try {
@@ -39,10 +54,15 @@ export function Navbar() {
       <div className="container flex h-16 max-w-screen-xl items-center mx-auto lg:px-6">
         <div className="flex flex-1 items-center justify-between">
           <div className="flex items-center gap-3">
-            <Link href="/dashboard" className="flex items-center gap-2 cursor-pointer">
+            <div
+              onClick={handleLogoClick}
+              className={`flex items-center gap-2 cursor-pointer transition-opacity ${
+                isNavigating ? "opacity-50" : "opacity-100"
+              }`}
+            >
               {appLogo && <img alt={t("navbar.logoAlt")} className="h-8 w-8 object-contain rounded" src={appLogo} />}
               <p className="font-bold text-2xl">{appName}</p>
-            </Link>
+            </div>
           </div>
 
           <div className="flex items-center gap-2 cursor-pointer">

apps/web/src/components/modals/create-share-modal.tsx

@@ -37,7 +37,15 @@ export function CreateShareModal({ isOpen, onClose, onSuccess }: CreateShareModa
         name: formData.name,
         description: formData.description || undefined,
         password: formData.isPasswordProtected ? formData.password : undefined,
-        expiration: formData.expiresAt ? new Date(formData.expiresAt).toISOString() : undefined,
+        expiration: formData.expiresAt
+          ? (() => {
+              const dateValue = formData.expiresAt;
+              if (dateValue.length === 10) {
+                return new Date(dateValue + "T23:59:59").toISOString();
+              }
+              return new Date(dateValue).toISOString();
+            })()
+          : undefined,
         maxViews: formData.maxViews ? parseInt(formData.maxViews) : undefined,
         files: [],
       });
@@ -71,7 +79,16 @@ export function CreateShareModal({ isOpen, onClose, onSuccess }: CreateShareModa
         <div className="flex flex-col gap-4">
           <div className="space-y-2">
             <Label>{t("createShare.nameLabel")}</Label>
-            <Input value={formData.name} onChange={(e) => setFormData({ ...formData, name: e.target.value })} />
+            <Input
+              value={formData.name}
+              onChange={(e) => setFormData({ ...formData, name: e.target.value })}
+              onPaste={(e) => {
+                e.preventDefault();
+                const pastedText = e.clipboardData.getData("text");
+                setFormData({ ...formData, name: pastedText });
+              }}
+              placeholder={t("createShare.namePlaceholder")}
+            />
           </div>
 
           <div className="space-y-2">
@@ -93,6 +110,12 @@ export function CreateShareModal({ isOpen, onClose, onSuccess }: CreateShareModa
               type="datetime-local"
               value={formData.expiresAt}
               onChange={(e) => setFormData({ ...formData, expiresAt: e.target.value })}
+              onBlur={(e) => {
+                const value = e.target.value;
+                if (value && value.length === 10) {
+                  setFormData({ ...formData, expiresAt: value + "T23:59" });
+                }
+              }}
             />
           </div>
 

apps/web/src/components/modals/upload-file-modal.tsx

@@ -124,7 +124,11 @@ export function UploadFileModal({ isOpen, onClose, onSuccess }: UploadFileModalP
     let previewUrl: string | undefined;
 
     if (file.type.startsWith("image/")) {
-      previewUrl = URL.createObjectURL(file);
+      try {
+        previewUrl = URL.createObjectURL(file);
+      } catch (error) {
+        console.warn("Failed to create preview URL:", error);
+      }
     }
 
     return {
@@ -142,6 +146,10 @@ export function UploadFileModal({ isOpen, onClose, onSuccess }: UploadFileModalP
     const newUploads = Array.from(files).map(createFileUpload);
     setFileUploads((prev) => [...prev, ...newUploads]);
     setHasShownSuccessToast(false);
+
+    if (newUploads.length > 0) {
+      toast.info(t("uploadFile.filesQueued", { count: newUploads.length }));
+    }
   };
 
   const handleFileInputChange = (event: React.ChangeEvent<HTMLInputElement>) => {
@@ -164,7 +172,12 @@ export function UploadFileModal({ isOpen, onClose, onSuccess }: UploadFileModalP
   const handleDrop = (event: React.DragEvent) => {
     event.preventDefault();
     setIsDragOver(false);
-    handleFilesSelect(event.dataTransfer.files);
+    event.stopPropagation();
+
+    const files = event.dataTransfer.files;
+    if (files.length > 0) {
+      handleFilesSelect(files);
+    }
   };
 
   const renderFileIcon = (fileName: string) => {

docker-compose-bind-mount-example.yaml

@@ -3,13 +3,14 @@ services:
     image: kyantech/palmr:latest
     container_name: palmr
     environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=change-this-key-in-production-min-32-chars # CHANGE THIS KEY FOR SECURITY (REQUIRED if DISABLE_FILESYSTEM_ENCRYPTION is false)
-      - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
-      - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
+      # Optional: Uncomment and configure as needed (if you don`t use, you can remove)
+      # - ENABLE_S3=true # Set to true to enable S3-compatible storage (OPTIONAL - default is false)
+      # - DISABLE_FILESYSTEM_ENCRYPTION=false # Set to false to enable file encryption (ENCRYPTION_KEY becomes required) | (OPTIONAL - default is true)
+      # - ENCRYPTION_KEY=change-this-key-in-production-min-32-chars # CHANGE THIS KEY FOR SECURITY (REQUIRED if DISABLE_FILESYSTEM_ENCRYPTION is false)
+      # - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
+      # - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
       # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US) | See the docs for see all supported languages
       # - SECURE_SITE=true # Set to true if you are using a reverse proxy (OPTIONAL - default is false)
-      # - DISABLE_FILESYSTEM_ENCRYPTION=true # Set to true to disable file encryption (ENCRYPTION_KEY becomes optional) | (OPTIONAL - default is false)
     ports:
       - "5487:5487" # Web port
       - "3333:3333" # API port (OPTIONAL EXPOSED - ONLY IF YOU WANT TO ACCESS THE API DIRECTLY)

docker-compose-minio.yaml

@@ -12,8 +12,8 @@ services:
       - S3_REGION=${S3_REGION:-us-east-1} # S3 region (us-east-1 is the default region) but it depends on your s3 server region
       - S3_BUCKET_NAME=${S3_BUCKET_NAME:-palmr-files} # Bucket name for the S3 storage (here we are using palmr-files as the bucket name to understand that this is the bucket for palmr)
       - S3_FORCE_PATH_STYLE=true # For MinIO compatibility we have to set this to true
-      - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
-      - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
+      # - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
+      # - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
       # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US) | See the docs for see all supported languages
       # - SECURE_SITE=true # Set to true if you are using a reverse proxy (OPTIONAL - default is false)
     ports:

docker-compose-s3.yaml

@@ -12,8 +12,8 @@ services:
       - S3_REGION=${S3_REGION:-us-east-1} # S3 region (us-east-1 is the default region) but it depends on your s3 server region
       - S3_BUCKET_NAME=${S3_BUCKET_NAME:-palmr-files} # Bucket name for the S3 storage (here we are using palmr-files as the bucket name to understand that this is the bucket for palmr)
       - S3_FORCE_PATH_STYLE=false # For S3 compatibility we have to set this to false
-      - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
-      - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
+      # - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
+      # - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
       # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US) | See the docs for see all supported languages
       # - SECURE_SITE=true # Set to true if you are using a reverse proxy (OPTIONAL - default is false)
     ports:

docker-compose.yaml

@@ -3,13 +3,14 @@ services:
     image: kyantech/palmr:latest
     container_name: palmr
     environment:
-      - ENABLE_S3=false
-      - ENCRYPTION_KEY=change-this-key-in-production-min-32-chars # CHANGE THIS KEY FOR SECURITY (REQUIRED if DISABLE_FILESYSTEM_ENCRYPTION is false)
-      - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
-      - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1001) | See our UID/GID Documentation for more information
+      # Optional: Uncomment and configure as needed (if you don`t use, you can remove)
+      # - ENABLE_S3=false # Set to true to enable S3-compatible storage (OPTIONAL - default is false)
+      # - DISABLE_FILESYSTEM_ENCRYPTION=true # Set to false to enable file encryption (ENCRYPTION_KEY becomes required) | (OPTIONAL - default is true)
+      # - ENCRYPTION_KEY=change-this-key-in-production-min-32-chars # CHANGE THIS KEY FOR SECURITY (REQUIRED if DISABLE_FILESYSTEM_ENCRYPTION is false)
+      # - PALMR_UID=1000 # UID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
+      # - PALMR_GID=1000 # GID for the container processes (OPTIONAL - default is 1000) | See our UID/GID Documentation for more information
       # - DEFAULT_LANGUAGE=en-US # Default language for the application (optional, defaults to en-US) | See the docs to see all supported languages
       # - SECURE_SITE=true # Set to true if you are using a reverse proxy (OPTIONAL - default is false)
-      # - DISABLE_FILESYSTEM_ENCRYPTION=true # Set to true to disable file encryption (ENCRYPTION_KEY becomes optional) | (OPTIONAL - default is false)
     ports:
       - "5487:5487" # Web port
       - "3333:3333" # API port (OPTIONAL EXPOSED - ONLY IF YOU WANT TO ACCESS THE API DIRECTLY)

infra/check-missing.js

@@ -0,0 +1,147 @@
+const { PrismaClient } = require('@prisma/client');
+const fs = require('fs');
+const path = require('path');
+
+const prisma = new PrismaClient();
+
+const loadConfigs = () => {
+  try {
+    const configsPath = path.join(__dirname, 'configs.json');
+    const configs = JSON.parse(fs.readFileSync(configsPath, 'utf8'));
+    
+    return Object.values(configs).flat();
+  } catch (error) {
+    console.error('Error loading configs:', error.message);
+    return [];
+  }
+};
+
+const loadProviders = () => {
+  try {
+    const providersPath = path.join(__dirname, 'providers.json');
+    return JSON.parse(fs.readFileSync(providersPath, 'utf8'));
+  } catch (error) {
+    console.error('Error loading providers:', error.message);
+    return [];
+  }
+};
+
+async function checkSeedingNeeded() {
+  try {
+    const appConfigCount = await prisma.appConfig.count();
+    const userCount = await prisma.user.count();
+    const authProviderCount = await prisma.authProvider.count();
+    
+    if (appConfigCount === 0 || userCount === 0) {
+      console.log('true');
+      return;
+    }
+    
+    if (authProviderCount === 0) {
+      console.log('true');
+      return;
+    }
+    
+    const allConfigs = loadConfigs();
+    const existingConfigs = await prisma.appConfig.findMany({
+      where: {
+        key: {
+          in: allConfigs
+        }
+      },
+      select: { key: true }
+    });
+    const existingConfigKeys = existingConfigs.map(c => c.key);
+    const missingConfigs = allConfigs.filter(key => !existingConfigKeys.includes(key));
+    
+    if (missingConfigs.length > 0) {
+      console.log('true');
+      return;
+    }
+    
+    const expectedProviders = loadProviders();
+    const existingProviders = await prisma.authProvider.findMany({
+      select: { name: true }
+    });
+    const existingProviderNames = existingProviders.map(p => p.name);
+    const missingProviders = expectedProviders.filter(name => !existingProviderNames.includes(name));
+    
+    if (missingProviders.length > 0) {
+      console.log('true');
+      return;
+    }
+    
+    console.log('false');
+  } catch (error) {
+    console.error('Error checking if seeding is needed:', error);
+    console.log('true');
+  } finally {
+    await prisma.$disconnect();
+  }
+}
+
+async function checkMissingProviders() {
+  try {
+    const expectedProviders = loadProviders();
+    const existingProviders = await prisma.authProvider.findMany({
+      select: { name: true }
+    });
+    const existingProviderNames = existingProviders.map(p => p.name);
+    const missingProviders = expectedProviders.filter(name => !existingProviderNames.includes(name));
+    
+    if (missingProviders.length > 0) {
+      console.log('Missing providers: ' + missingProviders.join(', '));
+    } else {
+      console.log('No missing providers');
+    }
+  } catch (error) {
+    console.error('Error checking missing providers:', error);
+    console.log('Error checking providers');
+  } finally {
+    await prisma.$disconnect();
+  }
+}
+
+async function checkMissingConfigs() {
+  try {
+    const allConfigs = loadConfigs();
+    const existingConfigs = await prisma.appConfig.findMany({
+      where: {
+        key: {
+          in: allConfigs
+        }
+      },
+      select: { key: true }
+    });
+    const existingConfigKeys = existingConfigs.map(c => c.key);
+    const missingConfigs = allConfigs.filter(key => !existingConfigKeys.includes(key));
+    
+    if (missingConfigs.length > 0) {
+      console.log('Missing configurations: ' + missingConfigs.join(', '));
+    } else {
+      console.log('No missing configurations');
+    }
+  } catch (error) {
+    console.error('Error checking missing configurations:', error);
+    console.log('Error checking configurations');
+  } finally {
+    await prisma.$disconnect();
+  }
+}
+
+const command = process.argv[2];
+
+switch (command) {
+  case 'check-seeding':
+    checkSeedingNeeded();
+    break;
+  case 'check-providers':
+    checkMissingProviders();
+    break;
+  case 'check-configs':
+    checkMissingConfigs();
+    break;
+  default:
+    console.error('Unknown command. Use: check-seeding, check-providers, or check-configs');
+    process.exit(1);
+}

infra/configs.json

@@ -0,0 +1,37 @@
+{
+  "general": [
+    "appName",
+    "showHomePage",
+    "appDescription",
+    "appLogo",
+    "firstUserAccess",
+    "serverUrl"
+  ],
+  "storage": [
+    "maxFileSize",
+    "maxTotalStoragePerUser"
+  ],
+  "security": [
+    "jwtSecret",
+    "maxLoginAttempts",
+    "loginBlockDuration",
+    "passwordMinLength",
+    "passwordAuthEnabled",
+    "passwordResetTokenExpiration"
+  ],
+  "email": [
+    "smtpEnabled",
+    "smtpHost",
+    "smtpPort",
+    "smtpUser",
+    "smtpPass",
+    "smtpFromName",
+    "smtpFromEmail",
+    "smtpSecure",
+    "smtpNoAuth",
+    "smtpTrustSelfSigned"
+  ],
+  "auth-providers": [
+    "authProvidersEnabled"
+  ]
+}

infra/providers.json

@@ -0,0 +1,11 @@
+[
+  "google",
+  "discord",
+  "github",
+  "auth0",
+  "kinde",
+  "zitadel",
+  "authentik",
+  "frontegg",
+  "pocketid"
+]

infra/server-start.sh

@@ -3,8 +3,8 @@ set -e
 
 echo "🌴 Starting Palmr Server..."
 
-TARGET_UID=${PALMR_UID:-1001}
-TARGET_GID=${PALMR_GID:-1001}
+TARGET_UID=${PALMR_UID:-1000}
+TARGET_GID=${PALMR_GID:-1000}
 
 if [ -n "$PALMR_UID" ] || [ -n "$PALMR_GID" ]; then
     echo "🔧 Runtime UID/GID: $TARGET_UID:$TARGET_GID"
@@ -35,200 +35,59 @@ if [ "$(id -u)" = "0" ]; then
     chown -R $TARGET_UID:$TARGET_GID /app/server/prisma 2>/dev/null || true
 fi
 
+run_as_user() {
+    if [ "$(id -u)" = "0" ]; then
+        su-exec $TARGET_UID:$TARGET_GID "$@"
+    else
+        "$@"
+    fi
+}
+
+if [ ! -f "/app/server/prisma/configs.json" ]; then
+    echo "📄 Copying configuration files..."
+    cp -f /app/infra/configs.json /app/server/prisma/configs.json 2>/dev/null || echo "⚠️ Failed to copy configs.json"
+    cp -f /app/infra/providers.json /app/server/prisma/providers.json 2>/dev/null || echo "⚠️ Failed to copy providers.json"
+    cp -f /app/infra/check-missing.js /app/server/prisma/check-missing.js 2>/dev/null || echo "⚠️ Failed to copy check-missing.js"
+    
+    if [ "$(id -u)" = "0" ]; then
+        chown $TARGET_UID:$TARGET_GID /app/server/prisma/configs.json /app/server/prisma/providers.json /app/server/prisma/check-missing.js 2>/dev/null || true
+    fi
+fi
+
 if [ ! -f "/app/server/prisma/palmr.db" ]; then
     echo "🚀 First run detected - setting up database..."
     
     echo "🗄️ Creating database schema..."
-    if [ "$(id -u)" = "0" ]; then
-        su-exec $TARGET_UID:$TARGET_GID npx prisma db push --schema=./prisma/schema.prisma --skip-generate
-    else
-        npx prisma db push --schema=./prisma/schema.prisma --skip-generate
-    fi
+    run_as_user npx prisma db push --schema=./prisma/schema.prisma --skip-generate
     
     echo "🌱 Seeding database..."
-    if [ "$(id -u)" = "0" ]; then
-        su-exec $TARGET_UID:$TARGET_GID node ./prisma/seed.js
-    else
-        node ./prisma/seed.js
-    fi
+    run_as_user node ./prisma/seed.js
     
     echo "✅ Database setup completed!"
 else
     echo "♻️ Existing database found"
     
     echo "🔧 Checking for schema updates..."
-    if [ "$(id -u)" = "0" ]; then
-        su-exec $TARGET_UID:$TARGET_GID npx prisma db push --schema=./prisma/schema.prisma --skip-generate
-    else
-        npx prisma db push --schema=./prisma/schema.prisma --skip-generate
-    fi
+    run_as_user npx prisma db push --schema=./prisma/schema.prisma --skip-generate
     
     echo "🔍 Checking if new tables need seeding..."
-    NEEDS_SEEDING=$(
-        if [ "$(id -u)" = "0" ]; then
-            su-exec $TARGET_UID:$TARGET_GID node -e "
-                const { PrismaClient } = require('@prisma/client');
-                const prisma = new PrismaClient();
-                
-                async function checkSeedingNeeded() {
-                    try {
-                        const appConfigCount = await prisma.appConfig.count();
-                        const userCount = await prisma.user.count();
-                        const authProviderCount = await prisma.authProvider.count();
-                        
-                        if (appConfigCount === 0 || userCount === 0) {
-                            console.log('true');
-                            return;
-                        }
-                        
-                        if (authProviderCount === 0) {
-                            console.log('true');
-                            return;
-                        }
-                        
-                        const expectedProviders = ['google', 'discord', 'github', 'auth0', 'kinde', 'zitadel', 'authentik', 'frontegg', 'pocketid'];
-                        const existingProviders = await prisma.authProvider.findMany({
-                            select: { name: true }
-                        });
-                        const existingProviderNames = existingProviders.map(p => p.name);
-                        
-                        const missingProviders = expectedProviders.filter(name => !existingProviderNames.includes(name));
-                        
-                        if (missingProviders.length > 0) {
-                            console.log('true');
-                            return;
-                        }
-                        
-                        console.log('false');
-                    } catch (error) {
-                        console.log('true');
-                    } finally {
-                        await prisma.\$disconnect();
-                    }
-                }
-                
-                checkSeedingNeeded();
-            " 2>/dev/null || echo "true"
-        else
-            node -e "
-                const { PrismaClient } = require('@prisma/client');
-                const prisma = new PrismaClient();
-                
-                async function checkSeedingNeeded() {
-                    try {
-                        const appConfigCount = await prisma.appConfig.count();
-                        const userCount = await prisma.user.count();
-                        const authProviderCount = await prisma.authProvider.count();
-                        
-                        if (appConfigCount === 0 || userCount === 0) {
-                            console.log('true');
-                            return;
-                        }
-                        
-                        if (authProviderCount === 0) {
-                            console.log('true');
-                            return;
-                        }
-                        
-                        const expectedProviders = ['google', 'discord', 'github', 'auth0', 'kinde', 'zitadel', 'authentik', 'frontegg', 'pocketid'];
-                        const existingProviders = await prisma.authProvider.findMany({
-                            select: { name: true }
-                        });
-                        const existingProviderNames = existingProviders.map(p => p.name);
-                        
-                        const missingProviders = expectedProviders.filter(name => !existingProviderNames.includes(name));
-                        
-                        if (missingProviders.length > 0) {
-                            console.log('true');
-                            return;
-                        }
-                        
-                        console.log('false');
-                    } catch (error) {
-                        console.log('true');
-                    } finally {
-                        await prisma.\$disconnect();
-                    }
-                }
-                
-                checkSeedingNeeded();
-            " 2>/dev/null || echo "true"
-        fi
-    )
+    NEEDS_SEEDING=$(run_as_user node ./prisma/check-missing.js check-seeding 2>/dev/null || echo "true")
     
     if [ "$NEEDS_SEEDING" = "true" ]; then
         echo "🌱 New tables detected or missing data, running seed..."
         
-        # Check which providers are missing for better logging
-        MISSING_PROVIDERS=$(
-            if [ "$(id -u)" = "0" ]; then
-                su-exec $TARGET_UID:$TARGET_GID node -e "
-                    const { PrismaClient } = require('@prisma/client');
-                    const prisma = new PrismaClient();
-                    
-                    async function checkMissingProviders() {
-                        try {
-                            const expectedProviders = ['google', 'discord', 'github', 'auth0', 'kinde', 'zitadel', 'authentik', 'frontegg', 'pocketid'];
-                            const existingProviders = await prisma.authProvider.findMany({
-                                select: { name: true }
-                            });
-                            const existingProviderNames = existingProviders.map(p => p.name);
-                            const missingProviders = expectedProviders.filter(name => !existingProviderNames.includes(name));
-                            
-                            if (missingProviders.length > 0) {
-                                console.log('Missing providers: ' + missingProviders.join(', '));
-                            } else {
-                                console.log('No missing providers');
-                            }
-                        } catch (error) {
-                            console.log('Error checking providers');
-                        } finally {
-                            await prisma.\$disconnect();
-                        }
-                    }
-                    
-                    checkMissingProviders();
-                " 2>/dev/null || echo "Error checking providers"
-            else
-                node -e "
-                    const { PrismaClient } = require('@prisma/client');
-                    const prisma = new PrismaClient();
-                    
-                    async function checkMissingProviders() {
-                        try {
-                            const expectedProviders = ['google', 'discord', 'github', 'auth0', 'kinde', 'zitadel', 'authentik', 'frontegg', 'pocketid'];
-                            const existingProviders = await prisma.authProvider.findMany({
-                                select: { name: true }
-                            });
-                            const existingProviderNames = existingProviders.map(p => p.name);
-                            const missingProviders = expectedProviders.filter(name => !existingProviderNames.includes(name));
-                            
-                            if (missingProviders.length > 0) {
-                                console.log('Missing providers: ' + missingProviders.join(', '));
-                            } else {
-                                console.log('No missing providers');
-                            }
-                        } catch (error) {
-                            console.log('Error checking providers');
-                        } finally {
-                            await prisma.\$disconnect();
-                        }
-                    }
-                    
-                    checkMissingProviders();
-                " 2>/dev/null || echo "Error checking providers"
-            fi
-        )
-        
+        MISSING_PROVIDERS=$(run_as_user node ./prisma/check-missing.js check-providers 2>/dev/null || echo "Error checking providers")
+        MISSING_CONFIGS=$(run_as_user node ./prisma/check-missing.js check-configs 2>/dev/null || echo "Error checking configurations")
+
         if [ "$MISSING_PROVIDERS" != "No missing providers" ] && [ "$MISSING_PROVIDERS" != "Error checking providers" ]; then
             echo "🔍 $MISSING_PROVIDERS"
         fi
         
-        if [ "$(id -u)" = "0" ]; then
-            su-exec $TARGET_UID:$TARGET_GID node ./prisma/seed.js
-        else
-            node ./prisma/seed.js
+        if [ "$MISSING_CONFIGS" != "No missing configurations" ] && [ "$MISSING_CONFIGS" != "Error checking configurations" ]; then
+            echo "⚙️ $MISSING_CONFIGS"
         fi
+        
+        run_as_user node ./prisma/seed.js
         echo "✅ Seeding completed!"
     else
         echo "✅ All tables have data, no seeding needed"
@@ -242,4 +101,4 @@ if [ "$(id -u)" = "0" ]; then
     exec su-exec $TARGET_UID:$TARGET_GID node dist/server.js
 else
     exec node dist/server.js
-fi 
+fi

package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmr-monorepo",
-  "version": "3.1.5-beta",
+  "version": "3.1.7-beta",
   "description": "Palmr monorepo with Husky configuration",
   "private": true,
   "packageManager": "pnpm@10.6.0",