mirror of
https://github.com/invoiceninja/dockerfiles.git
synced 2025-12-31 19:47:25 +01:00
80 lines
2.9 KiB
Markdown
80 lines
2.9 KiB
Markdown
[](https://hub.docker.com/r/invoiceninja/invoiceninja-debian)
|
|
[](https://hub.docker.com/r/invoiceninja/invoiceninja-debian)
|
|
[](https://github.com/invoiceninja/dockerfiles/actions/workflows/build-image-debian.yaml)
|
|
[](https://github.com/invoiceninja/dockerfiles/actions/workflows/publish-image.yaml)
|
|
|
|
# Debian Docker for [Invoice Ninja](https://www.invoiceninja.com/)
|
|
|
|
:crown: **Features**
|
|
|
|
NGINX webserver support [NGINX](https://nginx.org/)
|
|
Built-in Chrome for PDF generation and other features
|
|
Saxon XLST 2 engine
|
|
OPcache
|
|
Multi language support
|
|
|
|
## Get started with Docker Compose
|
|
|
|
This Debian-based image includes Chrome for enhanced PDF generation and other features. To get started:
|
|
|
|
```bash
|
|
git clone https://github.com/invoiceninja/dockerfiles.git -b debian
|
|
cd dockerfiles
|
|
```
|
|
|
|
Instead of defining our environment variables inside our docker-compose.yml file we now define this in the `.env` file, open this file up and insert your `APP_URL`, `APP_KEY` and update the rest of the variables as required.
|
|
|
|
```
|
|
APP_URL=http://in.localhost:8003/
|
|
APP_KEY=<insert your generated key in here>
|
|
APP_DEBUG=true
|
|
REQUIRE_HTTPS=false
|
|
IN_USER_EMAIL=
|
|
IN_PASSWORD=
|
|
```
|
|
|
|
If `IN_USER_EMAIL` and `IN_PASSWORD` is not set the default user email and password is "admin@example.com" and "changeme!" respectively. You will use this for the initial login, thereafter, you can delete these two environment variables.
|
|
|
|
The `APP_KEY` can be generated by running
|
|
|
|
```bash
|
|
# If you haven't started the containers yet:
|
|
docker run --rm -it invoiceninja/invoiceninja-debian php artisan key:generate --show
|
|
|
|
# Or if your containers are already running:
|
|
docker-compose exec app php artisan key:generate --show
|
|
```
|
|
|
|
Copy the entire string and insert in the env file at `APP_KEY=base64....`
|
|
|
|
**Note: For PDF generation using localhost, your domain name MUST end in .test for PDFs to generate correctly due to Chrome's DNS resolver.
|
|
|
|
Start the container with:
|
|
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
**Note: When performing the setup, the Database host is ```mysql```
|
|
|
|
### Updating the Image
|
|
|
|
To upgrade to a newer release image, update your docker-compose.yml first by running:
|
|
|
|
```bash
|
|
docker-compose down
|
|
docker-compose pull
|
|
docker-compose up
|
|
```
|
|
|
|
It is recommended to perform a backup before updating.
|
|
|
|
### Support
|
|
|
|
If you discover a bug, please create an issue. For general queries, visit our [Forum](https://forum.invoiceninja.com/)
|
|
|
|
|
|
### Todo
|
|
|
|
This is a new image which should provide much better support for all users, however there are some items left to complete
|
|
[] Backup script |