Setup:Installationsanleitung/Docker/Docker Hub: Unterschied zwischen den Versionen

Margit Link-Rodrigue (Diskussion | Beiträge)
Die Seite wurde neu angelegt: „The easiest way to run BlueSpice free is to install it with an all-in-one Docker image. All required services are preconfigured. [https://hub.docker.com/r/blu…“
 
Margit Link-Rodrigue (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Markierung: Quelltext-Bearbeitung 2017
Zeile 1: Zeile 1:
{{DISPLAYTITLE:Installing BlueSpice free with Docker}}
__NOTOC__
The easiest way to run BlueSpice free is to install it with an all-in-one Docker image. All required services are preconfigured.
The easiest way to run BlueSpice free is to install it with an all-in-one Docker image. All required services are preconfigured.


[https://hub.docker.com/r/bluespice/bluespice-free You can find all necessary information directly on Docker Hub.]
[https://hub.docker.com/r/bluespice/bluespice-free You can find all necessary information directly on Docker Hub.]


== <span class="mw-headline">How to use the Docker Hub image</span> ==
==How to use the Docker Hub image==


=== <span class="mw-headline">Basic usage</span> ===
===Basic usage===
Example for quick start. Blue Spice will be accessible only in localhost.<div>
Example for quick start. Blue Spice will be accessible only in localhost.
docker run -d -p <span class="m" style="color: rgb(102, 102, 102)">80</span>:80 bluespice/bluespice-free
<syntaxhighlight lang="docker">
</div>
docker run -d -p 80:80 bluespice/bluespice-free
</syntaxhighlight>


=== <span class="mw-headline">Keep your data outside of the docker</span> ===
===Keep your data outside of the docker===
<div>
<syntaxhighlight lang="docker">
docker run -d -p <span class="m" style="color: rgb(102, 102, 102)">80</span>:80 -v <span class="o" style="color: rgb(102, 102, 102)">{</span>/my/data/folder<span class="o" style="color: rgb(102, 102, 102)">}</span>:/data bluespice/bluespice-free
docker run -d -p 80:80 -v {/my/data/folder}:/data bluespice/bluespice-free
</div>
</syntaxhighlight>


=== <span class="mw-headline">Setting BlueSpice language and URL</span> ===
===Setting BlueSpice language and URL===
<div>
<syntaxhighlight lang="docker">
docker run -d -p <span class="m" style="color: rgb(102, 102, 102)">80</span>:80 -v <span class="o" style="color: rgb(102, 102, 102)">{</span>/my/data/folder<span class="o" style="color: rgb(102, 102, 102)">}</span>:/data -e <span class="s2" style="color: rgb(186, 33, 33)">"bs_lang=en"</span> -e <span class="s2" style="color: rgb(186, 33, 33)">"bs_url=<nowiki>http://www.domain.com</nowiki>"</span> bluespice/bluespice-free
docker run -d -p 80:80 -v {/my/data/folder}:/data -e "bs_lang=en" -e "bs_url=http://www.domain.com" bluespice/bluespice-free
</div>
</syntaxhighlight>


=== <span class="mw-headline">Activating SSL</span> ===
===Activating SSL===
Using SSL inside the Blue Spice docker image, the <code>data</code> directory should be outside of the docker. Create a folder named <code>cert</code> inside your data folder. Inside this folder, certificates must be named like:
Using SSL inside the Blue Spice docker image, the <code>data</code> directory should be outside of the docker. Create a folder named <code>cert</code> inside your data folder. Inside this folder, certificates must be named like:


* <code>ssl.cert</code> (SSL certificate. ''mandatory'')
*<code>ssl.cert</code> (SSL certificate. ''mandatory'')
* <code>ssl.key</code> (Private key of <code>ssl.cert</code>. ''mandatory'')
*<code>ssl.key</code> (Private key of <code>ssl.cert</code>. ''mandatory'')
* <code>ssl.ca</code> (3rd party CA certs for <code>ssl.cert</code>. ''optional'') If everything is ready for the first run, just run the following command:
*<code>ssl.ca</code> (3rd party CA certs for <code>ssl.cert</code>. ''optional'') If everything is ready for the first run, just run the following command:<br />
 
<syntaxhighlight lang="docker">
docker run -d -p 80:80 -p 443:443 -v {/my/data/folder}:/data -e "bs_lang=en" -e "bs_url=https://www.domain.com" bluespice/bluespice-free
</syntaxhighlight>


<div>
''Note: Port 443 includes the command and also <code>$bs_url</code> schema changed to <code>https</code>''
docker run -d -p <span class="m" style="color: rgb(102, 102, 102)">80</span>:80 -p <span class="m" style="color: rgb(102, 102, 102)">443</span>:443 -v <span class="o" style="color: rgb(102, 102, 102)">{</span>/my/data/folder<span class="o" style="color: rgb(102, 102, 102)">}</span>:/data -e <span class="s2" style="color: rgb(186, 33, 33)">"bs_lang=en"</span> -e <span class="s2" style="color: rgb(186, 33, 33)">"bs_url=<nowiki>https://www.domain.com</nowiki>"</span> bluespice/bluespice-free
</div>''Note: Port 443 includes the command and also <code>$bs_url</code> schema changed to <code>https</code>''


=== <span class="mw-headline">Login to BlueSpice</span> ===
===Login to BlueSpice===
<div>
<syntaxhighlight lang="docker">
username: WikiSysop
username: WikiSysop
password: PleaseChangeMe
password: PleaseChangeMe
</div>
</syntaxhighlight>


== <span class="mw-headline">Which services are runnning?</span> ==
==Which services are runnning?==


* Apache
*Apache
* PHP-FPM
*PHP-FPM
* Jetty9
*Jetty9
* Elasticsearch
*Elasticsearch
* MySQL/MariaDB
*MySQL/MariaDB
* Parsoid
*Parsoid
* crond
*crond
* memcached
*memcached


== <span class="mw-headline">Manually updating the Docker image</span> ==
==Manually updating the Docker image==
BlueSpice 3.1.2 has no automatic upgrade feature.
BlueSpice 3.1.2 has no automatic upgrade feature.


[[:en:Setup:Installation_Guide/Docker/Update|See: Manual upgrade process and how to fix some known issues.]]
[[Setup:Installation Guide/Docker/Update|See: Manual upgrade process and how to fix some known issues.]]
[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Docker/Docker Hub]]

Version vom 8. Dezember 2021, 09:24 Uhr


The easiest way to run BlueSpice free is to install it with an all-in-one Docker image. All required services are preconfigured.

You can find all necessary information directly on Docker Hub.

How to use the Docker Hub image

Basic usage

Example for quick start. Blue Spice will be accessible only in localhost.

docker run -d -p 80:80 bluespice/bluespice-free

Keep your data outside of the docker

docker run -d -p 80:80 -v {/my/data/folder}:/data bluespice/bluespice-free

Setting BlueSpice language and URL

docker run -d -p 80:80 -v {/my/data/folder}:/data -e "bs_lang=en" -e "bs_url=http://www.domain.com" bluespice/bluespice-free

Activating SSL

Using SSL inside the Blue Spice docker image, the data directory should be outside of the docker. Create a folder named cert inside your data folder. Inside this folder, certificates must be named like:

  • ssl.cert (SSL certificate. mandatory)
  • ssl.key (Private key of ssl.cert. mandatory)
  • ssl.ca (3rd party CA certs for ssl.cert. optional) If everything is ready for the first run, just run the following command:
docker run -d -p 80:80 -p 443:443 -v {/my/data/folder}:/data -e "bs_lang=en" -e "bs_url=https://www.domain.com" bluespice/bluespice-free

Note: Port 443 includes the command and also $bs_url schema changed to https

Login to BlueSpice

username: WikiSysop
password: PleaseChangeMe

Which services are runnning?

  • Apache
  • PHP-FPM
  • Jetty9
  • Elasticsearch
  • MySQL/MariaDB
  • Parsoid
  • crond
  • memcached

Manually updating the Docker image

BlueSpice 3.1.2 has no automatic upgrade feature.

See: Manual upgrade process and how to fix some known issues.



Feedback zur Dokumentation ist im Community-Forum möglich.