Skip to content

Commit

Permalink
Add a troubleshooting section
Browse files Browse the repository at this point in the history
  • Loading branch information
wincelau committed Dec 18, 2023
1 parent 44af982 commit 78cad9e
Showing 1 changed file with 18 additions and 4 deletions.
22 changes: 18 additions & 4 deletions installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -28,15 +28,15 @@ 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
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
Expand All @@ -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)

Expand Down Expand Up @@ -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).
Expand Down

0 comments on commit 78cad9e

Please sign in to comment.