aboutsummaryrefslogtreecommitdiff
path: root/README.rst
blob: c093b11d52faf2bb4c855e0e376eef40ad3c6eea (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
🐋 docker-asmttpd
=================

`ASMTTPD <https://github.com/nemasu/asmttpd>`_, but Dockerized!

Building
========

Building your own images of this repository should only be used for
developmental purposes! If you are a consumer, use the
`prebuilt images <https://hub.docker.com/r/fuwn/asmttpd>`_!

.. code-block:: shell

  $ docker build -t $USERNAME/asmttpd .

Usage
=====

Docker
------

Prerequisites
^^^^^^^^^^^^^

- `Docker <https://docs.docker.com/engine/install/>`_

Usage
^^^^^

.. code-block:: shell

  $ docker run \
  > -p 8080:80 \
  > -v /var/lib/asmttpd:/usr/src/app/web_root \
  > fuwn/asmttpd

Copyable
^^^^^^^^

.. code-block:: shell

  docker run -d -p 8080:80 -v /var/lib/asmttpd:/usr/src/app/web_root fuwn/asmttpd

Notes
^^^^^

Your web root directory can be found in :code:`/var/lib/asmttpd`.

Docker Compose
--------------

- `Docker <https://docs.docker.com/engine/install/>`_
- `Docker Compose <https://docs.docker.com/compose/install/>`_ (newer versions of Docker include Docker Compose!)

Usage
^^^^^

1. Create a directory, preferably in a monitorable location, :code:`cd` into it, and create a file named :code:`docker-compose.yml` with the following contents:

.. code-block:: yml

  # docker-compose.yml
  
  version: "3.3"
  services:
    asmttpd:
      ports:
        - "8080:80"
      volumes:
        - ./asmttpd:/usr/src/app/web_root
      image: fuwn/asmttpd

2. Execute :code:`docker-compose up -d` (or :code:`docker compose up -d` in later versions of Docker).

Notes
^^^^^

Your web root directory can be found in :code:`./asmttpd`.

License
~~~~~~~

`GNU General Public License v3.0 <./LICENSE>`_