mirror of
https://github.com/ledgersmb/ledgersmb-docker.git
synced 2025-10-14 08:10:30 -04:00
Compare commits
4 Commits
Author | SHA1 | Date | |
---|---|---|---|
|
0881bc6275 | ||
|
4b2e28ce0f | ||
|
95d28c1b44 | ||
|
cd7e322f29 |
87
Dockerfile
87
Dockerfile
@@ -1,78 +1,49 @@
|
|||||||
FROM debian:stretch-slim
|
FROM debian:jessie
|
||||||
MAINTAINER Freelock john@freelock.com
|
MAINTAINER Freelock john@freelock.com
|
||||||
|
|
||||||
# Build time variables
|
# Build time variables
|
||||||
ENV LSMB_VERSION 1.6.33
|
ENV LSMB_VERSION 1.5.16
|
||||||
|
|
||||||
|
|
||||||
# Install Perl, Tex, Starman, psql client, and all dependencies
|
# Install Perl, Tex, Starman, psql client, and all dependencies
|
||||||
# Without libclass-c3-xs-perl, performance is terribly slow...
|
# Without libclass-c3-xs-perl, performance is terribly slow...
|
||||||
# Without libclass-accessor-lite-perl, HTML::Entities won't build from CPAN
|
|
||||||
# libnet-cidr-lite-perl is a dependency for Plack::Builder::Conditionals
|
|
||||||
# which is being installed from CPAN
|
|
||||||
# libtest-requires-perl is a dependency of Module-Build-Pluggable-PPPort
|
|
||||||
# on which HTML::Escape depends
|
|
||||||
|
|
||||||
# Installing psql client directly from instructions at https://wiki.postgresql.org/wiki/Apt
|
|
||||||
# That mitigates issues where the PG instance is running a newer version than this container
|
|
||||||
|
|
||||||
RUN echo -n "APT::Install-Recommends \"0\";\nAPT::Install-Suggests \"0\";\n" >> /etc/apt/apt.conf && \
|
RUN echo -n "APT::Install-Recommends \"0\";\nAPT::Install-Suggests \"0\";\n" >> /etc/apt/apt.conf && \
|
||||||
mkdir -p /usr/share/man/man1/ && \
|
DEBIAN_FRONTEND=noninteractive apt-get update && \
|
||||||
mkdir -p /usr/share/man/man2/ && \
|
apt-get dist-upgrade -y && apt-get -y install \
|
||||||
mkdir -p /usr/share/man/man3/ && \
|
|
||||||
mkdir -p /usr/share/man/man4/ && \
|
|
||||||
mkdir -p /usr/share/man/man5/ && \
|
|
||||||
mkdir -p /usr/share/man/man6/ && \
|
|
||||||
mkdir -p /usr/share/man/man7/ && \
|
|
||||||
DEBIAN_FRONTEND="noninteractive" apt-get update -q && \
|
|
||||||
DEBIAN_FRONTEND="noninteractive" apt-get dist-upgrade -y -q && \
|
|
||||||
DEBIAN_FRONTEND="noninteractive" apt-get -y -q install \
|
|
||||||
wget ca-certificates gnupg \
|
|
||||||
libcgi-emulate-psgi-perl libcgi-simple-perl libconfig-inifiles-perl \
|
libcgi-emulate-psgi-perl libcgi-simple-perl libconfig-inifiles-perl \
|
||||||
libdbd-pg-perl libdbi-perl libdata-uuid-perl libdatetime-perl \
|
libdbd-pg-perl libdbi-perl libdatetime-perl \
|
||||||
libdatetime-format-strptime-perl libio-stringy-perl \
|
libdatetime-format-strptime-perl libdigest-md5-perl \
|
||||||
libjson-xs-perl libcpanel-json-xs-perl liblist-moreutils-perl \
|
libfile-mimeinfo-perl libjson-xs-perl libjson-perl \
|
||||||
liblocale-maketext-perl liblocale-maketext-lexicon-perl \
|
liblocale-maketext-perl liblocale-maketext-lexicon-perl \
|
||||||
liblog-log4perl-perl libmime-lite-perl libmime-types-perl \
|
liblog-log4perl-perl libmime-base64-perl libmime-lite-perl \
|
||||||
libmath-bigint-gmp-perl libmodule-runtime-perl libmoose-perl \
|
libmath-bigint-gmp-perl libmoose-perl libnumber-format-perl \
|
||||||
libmoosex-nonmoose-perl libnumber-format-perl \
|
|
||||||
libpgobject-perl libpgobject-simple-perl libpgobject-simple-role-perl \
|
libpgobject-perl libpgobject-simple-perl libpgobject-simple-role-perl \
|
||||||
libpgobject-type-bigfloat-perl libpgobject-type-datetime-perl \
|
libpgobject-util-dbmethod-perl libplack-perl libtemplate-perl \
|
||||||
libpgobject-type-bytestring-perl libpgobject-util-dbmethod-perl \
|
|
||||||
libpgobject-util-dbadmin-perl libplack-perl \
|
|
||||||
libplack-middleware-reverseproxy-perl \
|
|
||||||
libtemplate-perl libtext-csv-perl libtext-csv-xs-perl \
|
|
||||||
libtext-markdown-perl libxml-simple-perl \
|
|
||||||
libnamespace-autoclean-perl \
|
libnamespace-autoclean-perl \
|
||||||
libimage-size-perl \
|
|
||||||
libtemplate-plugin-latex-perl libtex-encode-perl \
|
libtemplate-plugin-latex-perl libtex-encode-perl \
|
||||||
libclass-c3-xs-perl libclass-accessor-lite-perl \
|
libmoosex-nonmoose-perl libclass-c3-xs-perl \
|
||||||
libnet-cidr-lite-perl libtest-requires-perl \
|
texlive-latex-recommended \
|
||||||
texlive-latex-recommended texlive-fonts-recommended \
|
texlive-xetex \
|
||||||
texlive-xetex fonts-liberation \
|
|
||||||
starman \
|
starman \
|
||||||
libopenoffice-oodoc-perl \
|
libopenoffice-oodoc-perl \
|
||||||
|
postgresql-client \
|
||||||
ssmtp \
|
ssmtp \
|
||||||
lsb-release && \
|
lsb-release && \
|
||||||
echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list && \
|
DEBIAN_FRONTEND=noninteractive apt-get update && \
|
||||||
(wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add -) && \
|
apt-get -y install git cpanminus make gcc libperl-dev && \
|
||||||
DEBIAN_FRONTEND="noninteractive" apt-get -q -y update && \
|
curl -Lo /tmp/ledgersmb-$LSMB_VERSION.tar.gz "https://download.ledgersmb.org/f/Releases/$LSMB_VERSION/ledgersmb-$LSMB_VERSION.tar.gz" && \
|
||||||
DEBIAN_FRONTEND="noninteractive" apt-get -q -y install postgresql-client && \
|
tar -xvzf /tmp/ledgersmb-$LSMB_VERSION.tar.gz --directory /srv && \
|
||||||
DEBIAN_FRONTEND="noninteractive" apt-get -q -y install git cpanminus make gcc libperl-dev && \
|
rm -f /tmp/ledgersmb-$LSMB_VERSION.tar.gz && \
|
||||||
wget --quiet -O /tmp/ledgersmb-$LSMB_VERSION.tar.gz "https://download.ledgersmb.org/f/Releases/$LSMB_VERSION/ledgersmb-$LSMB_VERSION.tar.gz" && \
|
cpanm --quiet --notest \
|
||||||
tar -xzf /tmp/ledgersmb-$LSMB_VERSION.tar.gz --directory /srv && \
|
--with-feature=starman \
|
||||||
rm -f /tmp/ledgersmb-$LSMB_VERSION.tar.gz && \
|
--with-feature=latex-pdf-ps \
|
||||||
cpanm --notest \
|
--with-feature=openoffice \
|
||||||
--with-feature=starman \
|
--installdeps /srv/ledgersmb/ && \
|
||||||
--with-feature=latex-pdf-ps \
|
apt-get purge -y git cpanminus make gcc libperl-dev && \
|
||||||
--with-feature=openoffice \
|
apt-get autoremove -y && \
|
||||||
--installdeps /srv/ledgersmb/ && \
|
apt-get autoclean && \
|
||||||
apt-get purge -q -y git cpanminus make gcc libperl-dev && \
|
rm -rf ~/.cpanm/ && \
|
||||||
apt-get autoremove -q -y && \
|
rm -rf /var/lib/apt/lists/*
|
||||||
apt-get autoclean -q && \
|
|
||||||
rm -rf ~/.cpanm/ && \
|
|
||||||
rm -rf /var/lib/apt/lists/* /usr/share/man/*
|
|
||||||
|
|
||||||
|
|
||||||
WORKDIR /srv/ledgersmb
|
WORKDIR /srv/ledgersmb
|
||||||
|
|
||||||
|
78
README.md
78
README.md
@@ -3,10 +3,10 @@ Dockerfile for LedgerSMB Docker image
|
|||||||
|
|
||||||
# Supported tags
|
# Supported tags
|
||||||
|
|
||||||
- `1.7`, `1.7.x` - Latest official release from 1.7 branch
|
- `1.5`, `1.5.x`, `latest` - Latest release tarball from 1.5 branch
|
||||||
- `1.6`, `1.6.x` - Latest release tarball from 1.6 branch
|
|
||||||
- `1.5`, `1.5.x` - Latest release tarball from 1.5 branch
|
|
||||||
- `1.4`, `1.4.x` - Latest tagged release of git 1.4 branch
|
- `1.4`, `1.4.x` - Latest tagged release of git 1.4 branch
|
||||||
|
- `master` - Master branch from git, unstable
|
||||||
|
- `master-dev`, `1.5-dev` - Containers to kick off a development setup
|
||||||
|
|
||||||
|
|
||||||
# What is LedgerSMB?
|
# What is LedgerSMB?
|
||||||
@@ -35,53 +35,48 @@ to add the TLS layer by applying Nginx or Apache as reverse proxy.
|
|||||||
Enabling optional functionalities such as outgoing e-mail and printing
|
Enabling optional functionalities such as outgoing e-mail and printing
|
||||||
could require additional setup of a mail service or CUPS printer service.
|
could require additional setup of a mail service or CUPS printer service.
|
||||||
|
|
||||||
# Quickstart
|
# How to use this image
|
||||||
|
|
||||||
The quickest way to get this image up and running is by using the
|
## Start a postgres instance
|
||||||
`docker-compose` file available through the GitHub repository at:
|
|
||||||
|
|
||||||
https://github.com/ledgersmb/ledgersmb-docker/blob/1.7/docker-compose.yml
|
|
||||||
|
|
||||||
which sets up both this image and a supporting database image for
|
|
||||||
production purposes (i.e. with persistent (database) data. The database
|
|
||||||
username and password are:
|
|
||||||
|
|
||||||
```plain
|
```plain
|
||||||
username: postgres
|
$ docker run -d --name postgres \
|
||||||
password: abc
|
-e POSTGRES_PASSWORD=mysecretpassword \
|
||||||
|
postgres:latest
|
||||||
```
|
```
|
||||||
|
|
||||||
The docker-compose file does *not* set up an Nginx or Apache reverse proxy
|
BEWARE: The command above creates a container with the database data stored
|
||||||
with TLS 1.2/1.3 support -- a requirement if you want to access your
|
*inside* the container. Upon removal of the container, the database data will
|
||||||
installation over any type of network (and especially the internet).
|
be removed too!
|
||||||
|
|
||||||
|
To prevent destruction of the database data upon replacement of the container,
|
||||||
|
please use these commands instead:
|
||||||
|
|
||||||
## Manual installation
|
```plain
|
||||||
|
$ docker volume create dbdata
|
||||||
This section assumes availability of a PostgreSQL server to attach to the
|
$ docker run -d --name postgres \
|
||||||
LedgerSMB image as the database server.
|
-e POSTGRES_PASSWORD=mysecretpassword \
|
||||||
|
-e PGDATA=/var/lib/postgresql/data/pgdata \
|
||||||
|
-v dbdata:/var/lib/postgresql/data \
|
||||||
|
postgres:latest
|
||||||
|
```
|
||||||
|
|
||||||
## Start LedgerSMB
|
## Start LedgerSMB
|
||||||
|
|
||||||
```plain
|
```plain
|
||||||
$ docker run -d -p 5762:5762 --name myledger \
|
$ docker run -d -p 5762:5762 --name myledger \
|
||||||
-e POSTGRES_HOST=<ip/hostname> ledgersmb/ledgersmb:latest
|
ledgersmb/ledgersmb:latest
|
||||||
```
|
```
|
||||||
|
|
||||||
This command maps port 5762 of your container to port 5762 in your host. The
|
This command maps port 5762 of your container to port 5762 in your host. The
|
||||||
web application inside the container should now be accessible through
|
web application inside the container should now be accessible through
|
||||||
http://localhost:5762/setup.pl and http://localhost:5762/login.pl.
|
http://localhost:5762/setup.pl.
|
||||||
|
|
||||||
Below are more variables which determine container configuration,
|
|
||||||
like `POSTGRES_HOST` above.
|
|
||||||
|
|
||||||
## Set up LedgerSMB
|
## Set up LedgerSMB
|
||||||
|
|
||||||
* Visit http://myledger:5762/setup.pl.
|
* Visit http://myledger:5762/setup.pl.
|
||||||
* Log in with the "postgres" user and the password `abc` as given above -
|
* Log in with the "postgres" user and the password `mysecretpassword`
|
||||||
or with the credentials of your own database server in case of a manual
|
and provide the name of a company (= database name) you want to create.
|
||||||
setup - and provide the name of a company (= database name) you want to
|
|
||||||
create.
|
|
||||||
* Go over the steps presented in the browser
|
* Go over the steps presented in the browser
|
||||||
|
|
||||||
Once you have completed the setup steps, you have a fully functional
|
Once you have completed the setup steps, you have a fully functional
|
||||||
@@ -121,18 +116,8 @@ Default: lsmb
|
|||||||
Set this if you want to automatically log in to a particular LedgerSMB database
|
Set this if you want to automatically log in to a particular LedgerSMB database
|
||||||
without needing to enter the name of that database on the login.pl login screen.
|
without needing to enter the name of that database on the login.pl login screen.
|
||||||
|
|
||||||
## `LSMB_WORKERS`
|
|
||||||
|
|
||||||
Default: 5
|
|
||||||
|
|
||||||
Set this if you want to run in a memory-constrained environment. E.g. set it to
|
|
||||||
2 when running in a 1 GB memory setup. Please do note that this may adversely
|
|
||||||
affect the performance experience of users.
|
|
||||||
|
|
||||||
## Mail configuration
|
## Mail configuration
|
||||||
|
|
||||||
The docker image uses `ssmtp` to send mail.
|
|
||||||
|
|
||||||
* `SSMTP_ROOT` (config: `Root`)
|
* `SSMTP_ROOT` (config: `Root`)
|
||||||
* `SSMTP_MAILHUB` (config: `Mailhub`)
|
* `SSMTP_MAILHUB` (config: `Mailhub`)
|
||||||
* `SSMTP_HOSTNAME` (config: `Hostname`)
|
* `SSMTP_HOSTNAME` (config: `Hostname`)
|
||||||
@@ -166,18 +151,11 @@ and the startup & config script is /usr/bin/start.sh.
|
|||||||
|
|
||||||
## Issues
|
## Issues
|
||||||
|
|
||||||
If you have any problems with or questions about this image or LedgerSMB,
|
If you have any problems with or questions about this image or LedgerSMB, please contact us on the [mailing list](http://ledgersmb.org/topic/support/mailing-lists-rss-and-nntp-feeds) or through a [GitHub issue](https://github.com/ledgersmb/ledgersmb-docker/issues).
|
||||||
please contact us on the [mailing list](http://ledgersmb.org/topic/support/mailing-lists-rss-and-nntp-feeds)
|
|
||||||
or through a [GitHub issue](https://github.com/ledgersmb/ledgersmb-docker/issues).
|
|
||||||
|
|
||||||
You can also reach some of the official LedgerSMB maintainers via the
|
You can also reach some of the official LedgerSMB maintainers via the `#ledgersmb` IRC channel on [Freenode](https://freenode.net), or on the bridged [Matrix](https://matrix.org) room in [#ledgersmb:matrix.org](https://matrix.to/#/#ledgersmb:matrix.org). The [Riot.im](https://riot.im/app/#/room/#ledgersmb:matrix.org) Matrix client is highly recommended.
|
||||||
`#ledgersmb` IRC channel on [Freenode](https://freenode.net), or on the
|
|
||||||
bridged [Matrix](https://matrix.org) room in [#ledgersmb:matrix.org](https://matrix.to/#/#ledgersmb:matrix.org).
|
|
||||||
The [Riot.im](https://riot.im/app/#/room/#ledgersmb:matrix.org) Matrix client is highly recommended.
|
|
||||||
|
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
You are invited to contribute new features, fixes, or updates, large or small;
|
You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
|
||||||
we are always thrilled to receive pull requests, and do our best to process
|
|
||||||
them as fast as we can.
|
|
||||||
|
@@ -1,72 +0,0 @@
|
|||||||
# This docker-compose file creates one
|
|
||||||
# compose 'project' consisting of two containers
|
|
||||||
#
|
|
||||||
# 1. The PostgreSQL data container
|
|
||||||
# 2. The LedgerSMB application container
|
|
||||||
#
|
|
||||||
# LedgerSMB persists all its data in the database,
|
|
||||||
# so no special care needs to be taken on
|
|
||||||
# container upgrades. With PostgreSQL, data is
|
|
||||||
# persisted across upgrades by the use of a
|
|
||||||
# special 'dbdata' volume
|
|
||||||
|
|
||||||
version: "3.2"
|
|
||||||
services:
|
|
||||||
# Note that the container needs to be named "postgres" here,
|
|
||||||
# because that allows us to use the default hostname ("postgres")
|
|
||||||
# from the LedgerSMB configuration
|
|
||||||
postgres:
|
|
||||||
image: postgres:9.6-alpine
|
|
||||||
environment:
|
|
||||||
# Replace the password below for a secure setup
|
|
||||||
POSTGRES_PASSWORD: abc
|
|
||||||
PGDATA: /var/lib/postgresql/data/pgdata
|
|
||||||
networks:
|
|
||||||
- internal
|
|
||||||
volumes:
|
|
||||||
- "pgdata:/var/lib/postgresql/data"
|
|
||||||
lsmb:
|
|
||||||
depends_on:
|
|
||||||
- postgres
|
|
||||||
image: ghcr.io/ledgersmb/ledgersmb:1.6
|
|
||||||
networks:
|
|
||||||
- internal
|
|
||||||
- default
|
|
||||||
# Uncomment the 'ports' section to map the LedgerSMB container port (5762)
|
|
||||||
# to the host's port of the same number, thus making LedgerSMB
|
|
||||||
# available on http://<host-dns-or-ip>:5762/
|
|
||||||
# SECURITY NOTE: Do this for evaluation purposes only!
|
|
||||||
# In production, be sure to use SSL/TLS to protect user's passwords
|
|
||||||
# and other sensitive data
|
|
||||||
# ports:
|
|
||||||
# - "5762:5762"
|
|
||||||
environment:
|
|
||||||
# The LSMB_WORKERS environment variable lets you select the number
|
|
||||||
# of processes serving HTTP requests. The default number of 2 workers
|
|
||||||
# is geared toward limited-memory situations (1 GB). In order to
|
|
||||||
# improve the performance experience, increase memory and the
|
|
||||||
# number of workers
|
|
||||||
#
|
|
||||||
LSMB_WORKERS: 2
|
|
||||||
#
|
|
||||||
#
|
|
||||||
# SSMTP_ROOT:
|
|
||||||
# SSMTP_HOSTNAME:
|
|
||||||
# SSMTP_MAILHUB:
|
|
||||||
# SSMTP_AUTH_USER:
|
|
||||||
# SSMTP_AUTH_PASS:
|
|
||||||
# SSMTP_AUTH_METHOD:
|
|
||||||
# SSMTP_USE_STARTTLS:
|
|
||||||
# SSMTP_FROMLINE_OVERRIDE:
|
|
||||||
|
|
||||||
# having the dbdata volume is required to persist our
|
|
||||||
# data between PostgreSQL container updates; without
|
|
||||||
# that, the data is contained in the same volume as
|
|
||||||
# the rest of the image and on update/upgrade, the
|
|
||||||
# data will be lost.
|
|
||||||
volumes:
|
|
||||||
pgdata:
|
|
||||||
|
|
||||||
|
|
||||||
networks:
|
|
||||||
internal:
|
|
3
start.sh
3
start.sh
@@ -45,5 +45,4 @@ echo "Selected PERL5LIB=$PERL5LIB";
|
|||||||
# --preload-app allows application initialization to kill the entire
|
# --preload-app allows application initialization to kill the entire
|
||||||
# starman instance (instead of just the worker, which will immediately
|
# starman instance (instead of just the worker, which will immediately
|
||||||
# get restarted); it also has a positive effect on memory use
|
# get restarted); it also has a positive effect on memory use
|
||||||
|
exec starman --port 5762 --preload-app tools/starman.psgi
|
||||||
exec starman --port 5762 --workers ${LSMB_WORKERS:-5} --preload-app bin/ledgersmb-server.psgi
|
|
||||||
|
Reference in New Issue
Block a user