From 78cad9e6096ee86b7765d4130d0763ca55e099cf Mon Sep 17 00:00:00 2001
From: Vincent LAURENT <vince.laurent@gmail.com>
Date: Tue, 19 Dec 2023 00:18:33 +0100
Subject: [PATCH] Add a troubleshooting section

---
 installation.md | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/installation.md b/installation.md
index dd6bd82..96b399d 100644
--- a/installation.md
+++ b/installation.md
@@ -13,7 +13,7 @@ Dependencies:
 
 Installing dependencies:
 ```
-sudo aptitude install php librsvg2-bin pdftk imagemagick potrace ghostscript locales
+sudo apt-get install php librsvg2-bin pdftk imagemagick potrace ghostscript locales
 ```
 
 Getting the source code:
@@ -28,7 +28,7 @@ To run it:
 php -S localhost:8000 -t public
 ```
 
-#### PHP Configuration
+### PHP Configuration
 
 ```
 upload_max_filesize = 24M # Maximum size of the PDF file to sign
@@ -36,7 +36,7 @@ post_max_size = 24M # Maximum size of the PDF file to sign
 max_file_uploads = 201 # Maximum number of pages in the PDF, here 200 pages + the original PDF
 ```
 
-#### Apache Configuration
+### Apache Configuration
 
 ```
 DocumentRoot /path/to/signaturepdf/public
@@ -48,7 +48,22 @@ DocumentRoot /path/to/signaturepdf/public
     php_value post_max_size 24M
 </Directory>
 ```
+### Troubleshooting
 
+#### The translation is not done, the language remains in English in the interface
+
+Check that your locales are properly installed:
+
+```
+sudo apt-get install locales
+sudo dpkg-reconfigure locales
+```
+
+Then if you use apache, you have to restart it:
+
+```
+sudo service apache2 restart
+```
 
 ## [Deploy with Docker](#docker)
 
@@ -85,7 +100,6 @@ The following variables can be used to configure the deployment:
 docker run -d --name=signaturepdf -p 8080:80 -e SERVERNAME=pdf.example.org -e UPLOAD_MAX_FILESIZE=48M -e POST_MAX_SIZE=48M -e MAX_FILE_UPLOADS=401 -e PDF_STORAGE_PATH=/data signaturepdf
 ```
 
-
 ## [Alpine](#alpine)
 
 Here is a script to install the solution on Linux Alpine (tested with version 3.15).