Subir PrestaShop por FTP a Syspanel: Guía de permisos correctos

¿Tienes una tienda online con PrestaShop y necesitas subirla a tu servidor Syspanel? No te preocupes, en esta guía te voy a explicar paso a paso, y de una forma muy sencilla, cómo subir PrestaShop por FTP a Syspanel y configurar los permisos correctamente. Este proceso es fundamental para que tu tienda funcione sin errores y de forma segura. Aunque pueda parecer técnico, con esta guía lo harás sin problemas, incluso si es tu primera vez.

¿Por qué es importante subir PrestaShop por FTP a Syspanel?

Antes de meternos en harina, es bueno entender qué estamos haciendo y por qué. Subir PrestaShop por FTP es el proceso de transferir todos los archivos de tu tienda (el código, las imágenes, los módulos, etc.) desde tu ordenador al servidor donde se alojará tu web. Syspanel es el panel de control de tu hosting, la herramienta desde la que gestionas todo tu servidor.

Hacer esto correctamente es el primer paso para tener una tienda online funcional. Si los archivos no se suben bien, o si los permisos no son los correctos, tu tienda puede mostrar errores como pantallas en blanco, problemas para instalar módulos o incluso vulnerabilidades de seguridad. Por eso, vamos a hacerlo bien desde el principio.

Antes de empezar: Lo que necesitas tener a mano

Para llevar a cabo este proceso, necesitarás reunir algunos datos importantes. Tenerlos a mano te ahorrará tiempo y frustración.

Los archivos de PrestaShop: Puedes descargarlos desde la página oficial de PrestaShop o desde tu zona de cliente. Normalmente viene en un archivo comprimido (.zip).
Tus datos de acceso FTP: Estos te los proporciona tu proveedor de hosting. Incluyen:
- Servidor FTP: (ej. ftp.tudominio.com o una dirección IP).
- Usuario FTP: Un nombre de usuario específico.
- Contraseña FTP: La contraseña correspondiente.
Tus datos de acceso a Syspanel: La URL de acceso (normalmente es https://tu-servidor:2106), tu usuario y tu contraseña de administrador.
Un cliente FTP: Un programa que te permite conectarte al servidor. Los más populares y gratuitos son FileZilla o WinSCP. En este artículo usaré FileZilla por ser uno de los más comunes, pero el proceso es muy similar en otros.

[INFO] Syspanel es el nombre que recibe tu panel de control. Si tu proveedor te habla de "HestiaCP", se refiere exactamente a lo mismo. Recuerda que el acceso a Syspanel se realiza a través del puerto 2106.

Paso 1: Preparar los archivos de PrestaShop en tu ordenador

Lo primero es tener los archivos listos para ser subidos. Si has descargado un archivo .zip, debes descomprimirlo en una carpeta de tu ordenador. Busca la carpeta descargada, haz clic derecho sobre el archivo .zip y selecciona "Extraer aquí" o "Descomprimir". Verás que se crea una carpeta con todos los archivos de PrestaShop, incluyendo las carpetas admin, config, img, modules, etc.

[TIP] Antes de subir nada, es una buena práctica renombrar la carpeta de administración (normalmente admin) a algo más personalizado y seguro, como admin123 o miespacio-secreto. Esto ayuda a proteger tu tienda de accesos no autorizados. Hazlo en tu ordenador antes de subir los archivos.

Paso 2: Conectarse a tu servidor por FTP

Ahora es el momento de conectar tu ordenador con el servidor. Abre FileZilla. En la parte superior verás los campos para el Servidor, Nombre de usuario, Contraseña y Puerto.

Escribe la dirección de tu servidor FTP en el campo "Servidor".
Escribe tu usuario FTP.
Escribe tu contraseña.
El puerto estándar para FTP es el 21. Si tu proveedor te ha dado un puerto diferente, escríbelo.
Haz clic en "Conexión rápida".

Una vez conectado, verás dos paneles principales. En el panel izquierdo están los archivos de tu ordenador y en el panel derecho los archivos de tu servidor. En el panel derecho, navega hasta la carpeta donde quieres instalar PrestaShop. Normalmente, en Syspanel, esta carpeta se llama public_html y es la raíz de tu dominio. Si tienes un subdominio, la carpeta puede tener otro nombre (ej. subdominio.tudominio.com).

Paso 3: Subir los archivos de PrestaShop por FTP

Este es el paso más importante y el que más tiempo lleva. Se trata de transferir todos los archivos de tu carpeta local a la carpeta public_html de tu servidor.

En el panel izquierdo de FileZilla, navega hasta la carpeta donde descomprimiste PrestaShop.
Selecciona todos los archivos y carpetas que hay dentro. Puedes hacerlo con Ctrl+A (o Cmd+A en Mac) o yendo al menú "Edición" -> "Seleccionar todo".
Arrastra todos esos archivos seleccionados desde el panel izquierdo hasta el panel derecho, es decir, hasta la carpeta public_html de tu servidor.
FileZilla comenzará a subir los archivos. Verás el progreso en la parte inferior de la ventana.

[WARNING] No subas la carpeta que contiene los archivos, sino el contenido de la carpeta. Es decir, si descomprimiste PrestaShop en C:\PrestaShop, debes subir el contenido de C:\PrestaShop directamente a public_html, no la carpeta PrestaShop en sí. De lo contrario, tu tienda no será accesible desde tudominio.com, sino desde tudominio.com/PrestaShop.

Este proceso puede tardar varios minutos, dependiendo del tamaño de tu tienda y de la velocidad de tu conexión. Ten paciencia y espera a que la cola de archivos se vacíe y todos los archivos se hayan transferido correctamente. Verás que los archivos empiezan a aparecer en el panel derecho.

Paso 4: Configurar los permisos de PrestaShop en Syspanel

Una vez que todos los archivos están en el servidor, es crucial configurar los permisos correctos. Los permisos determinan quién puede leer, escribir o ejecutar los archivos y carpetas. PrestaShop necesita permisos específicos para funcionar correctamente, especialmente para las carpetas de caché, logs y configuraciones.

Aquí es donde entra en juego Syspanel. Vamos a usarlo para ajustar los permisos de forma fácil.

4.1. Acceder al administrador de archivos de Syspanel

Abre tu navegador y ve a la URL de tu Syspanel. Recuerda que es https://tu-servidor:2106.
Inicia sesión con tu usuario y contraseña de administrador.
Busca la sección de "Archivos" o "Administrador de archivos". Suele estar en el menú principal o dentro de la sección de tu dominio.

4.2. Ajustar los permisos de las carpetas y archivos

Una vez dentro del administrador de archivos, navega hasta la carpeta public_html (o donde hayas subido los archivos). Ahora, vamos a configurar los permisos.

Para las carpetas (directorios), PrestaShop generalmente necesita un permiso de 755. Esto significa que el propietario tiene todos los permisos (leer, escribir y ejecutar) y los demás solo pueden leer y ejecutar.

Para los archivos, el permiso recomendado suele ser 644. Esto permite al propietario leer y escribir, y a los demás solo leer.

Pero hay algunas carpetas especiales que necesitan permisos más flexibles (escribibles) para que PrestaShop pueda generar archivos de caché o subir imágenes. Estas carpetas suelen ser:

config
cache
log
img
mails
modules
themes (a veces)
translations
upload
download
var (en versiones más nuevas de PrestaShop)

Para estas carpetas, el permiso recomendado es 755 para las carpetas y 644 para los archivos dentro de ellas. En algunos casos, si tienes problemas, puede que necesites usar 775 o incluso 777 temporalmente, pero es mejor evitar el 777 por seguridad.

[WARNING] Usar permisos 777 en todas las carpetas es un riesgo de seguridad muy grave. Cualquiera podría modificar tus archivos. Úsalo solo como último recurso y cámbialo de vuelta a 755 o 644 en cuanto hayas solucionado el problema.

¿Cómo hacerlo en Syspanel?

En el administrador de archivos, selecciona una carpeta o archivo.
Busca un botón o opción que diga "Permisos", "Cambiar permisos" o "Chmod".
Se abrirá una ventana donde podrás introducir el valor numérico (por ejemplo, 755 o 644) o marcar casillas para los permisos de lectura, escritura y ejecución.
Introduce el valor y haz clic en "Guardar" o "Aceptar".

Repite este proceso para las carpetas y archivos que necesiten permisos especiales. Para el resto, los permisos por defecto que se establecen al subir los archivos suelen ser correctos, pero es una buena práctica verificarlos.

[TIP] Si tu administrador de archivos no te permite cambiar permisos de muchos archivos a la vez, puedes hacerlo desde tu cliente FTP (FileZilla). Selecciona los archivos o carpetas, haz clic derecho y elige "Permisos de archivo..." o "File permissions...". Ahí podrás escribir el valor numérico (755, 644) y aplicar el cambio a todas las subcarpetas y archivos si marcas la opción "Recurse into subdirectories".

Paso 5: Crear la base de datos (si no la tienes)

Para que PrestaShop funcione, necesita una base de datos donde guardar toda la información de tu tienda (productos, pedidos, clientes, etc.). Si ya tienes una creada en Syspanel, puedes saltarte este paso. Si no, vamos a crearla.

En Syspanel, busca la sección de "Bases de datos" o "Base de datos MySQL".
Haz clic en "Agregar base de datos" o un botón similar.
Te pedirá un nombre de base de datos, un usuario y una contraseña. Crea un nombre descriptivo (ej. tienda_presta) y un usuario (ej. tienda_user). Genera una contraseña segura.
Anota estos datos, los necesitarás en el siguiente paso.

Paso 6: Instalar PrestaShop (o conectar tu tienda existente)

Ahora viene la parte final. Abre tu navegador y ve a tu dominio (tudominio.com). Si los archivos se subieron correctamente y los permisos están bien, deberías ver el asistente de instalación de PrestaShop.

Sigue los pasos del asistente:

Acepta los términos de la licencia.
Introduce la información de tu tienda (nombre, actividad, etc.).
En el paso de la base de datos, introduce los datos que creaste en el paso anterior (nombre de la base de datos, usuario y contraseña).
El asistente comprobará si los permisos son correctos. Si todo está bien, continuará con la instalación.
Al final, te pedirá que configures la cuenta de administrador y te dará la URL de acceso a tu panel de administración (recuerda que la carpeta admin la renombraste al principio).

Si ya tenías una tienda PrestaShop funcionando en otro servidor y has subido una copia de seguridad, el proceso es diferente. En ese caso, deberías tener un archivo de respaldo de tu base de datos. En lugar de ejecutar el instalador, necesitarás importar esa base de datos en la que creaste en Syspanel. Luego, deberás modificar el archivo config/settings.inc.php (o app/config/parameters.php en versiones nuevas) para que apunte a tu nueva base de datos y usuario.

[INFO] Si al acceder a tu dominio ves un error de "Permiso denegado" o "Error de conexión a la base de datos", revisa los permisos de las carpetas que hemos mencionado. La causa más común de estos errores es una mala configuración de los permisos.

Preguntas frecuentes (FAQ) sobre FTP y permisos en PrestaShop

Aquí te respondo algunas dudas comunes que suelen tener los usuarios.

¿Cuál es el permiso correcto para las carpetas en PrestaShop?

El permiso estándar y más seguro para las carpetas es 755. Para las carpetas que necesitan ser escribibles (como cache, log, img, etc.), también se usa 755. En casos muy específicos de problemas, podrías necesitar 775, pero no deberías usar 777.

¿Qué permisos necesitan los archivos de PrestaShop?

El permiso estándar para los archivos es 644. Esto permite al propietario leer y escribir, y al resto del mundo solo leer.

¿Por qué mi tienda muestra un error 500 o una pantalla en blanco?

Esto suele estar relacionado con permisos incorrectos en las carpetas var, cache o log. También puede deberse a que los archivos no se subieron correctamente. Revisa los permisos y vuelve a subir los archivos que falten.

¿Cómo puedo cambiar los permisos de forma masiva?

La forma más fácil es usar tu cliente FTP (FileZilla). Selecciona todos los archivos y carpetas, haz clic derecho y elige "Permisos de archivo...". Introduce el valor (755 para carpetas, 644 para archivos) y marca la opción para que se aplique a todas las subcarpetas y archivos.

[TIP] Si tienes problemas con la instalación, una herramienta muy útil es el "Comprobador de requisitos de PrestaShop". Puedes subir un archivo llamado check.php a la carpeta raíz de tu tienda y ejecutarlo desde el navegador. Te dirá exactamente qué permisos o configuraciones de PHP no son correctos.

Conclusión

Subir PrestaShop por FTP a Syspanel y configurar los permisos es un proceso que, una vez que lo entiendes, se vuelve bastante sencillo. Lo más importante es ser meticuloso con los archivos que subes y con los permisos que estableces. Recuerda siempre:

Subir el contenido de la carpeta de PrestaShop a public_html, no la carpeta en sí.
Usar permisos 755 para carpetas y 644 para archivos.
Dar permisos de escritura solo a las carpetas que PrestaShop necesita para funcionar.
Usar Syspanel (a través del puerto 2106) para gestionar tus archivos y bases de datos.

Con esta guía, ya tienes todo lo necesario para poner tu tienda PrestaShop en marcha. Si tienes algún problema, no dudes en consultar la documentación oficial de PrestaShop o contactar con el soporte de tu hosting. ¡Mucha suerte con tu tienda online!