Base Image

Overview

The application's Dockerfile must specify the FROM base image to be cloudron/base:0.9.0.

The base image already contains most popular software packages including node, nginx, apache, ruby, PHP. Using the base image greatly reduces the size of app images.

The goal of the base image is simply to provide pre-downloaded software packages. The packages are not configured in any way and it's up to the application to configure them as they choose. For example, while apache is installed, there are no meaningful site configurations that the application can use.

Packages

The following packages are part of the base image. If you need another version, you will have to install it yourself.

Apache 2.4.18
Composer 1.2.0
Go 1.5.4, 1.6.3
Gunicorn 19.4.5
Java 1.8
Maven 3.3.9
Mongo 2.6.10
MySQL Client 5.7.13
nginx 1.10.0
Node 0.10.40, 0.12.7, 4.2.6, 4.4.7 (installed under /usr/local/node-<version>) more information
Perl 5.22.1
PHP 7.0.8
Postgresql client 9.5.4
Python 2.7.12
Redis 3.0.6
Ruby 2.3.1
sqlite3 3.11.0
Supervisor 3.2.0
uwsgi 2.0.12

Inspecting the base image

The base image can be inspected by installing Docker.

Once installed, pull down the base image locally using the following command:

    docker pull cloudron/base:0.9.0

To inspect the base image:

    docker run -ti cloudron/base:0.9.0 /bin/bash

Note: Please use docker 1.9.0 or above to pull the base image. Doing otherwise results in a base image with an incorrect image id. The image id of cloudron/base:0.9.0 is d038af182821.

The `cloudron` user

The base image contains a user named cloudron that apps can use to run their app.

It is good security practice to run apps as a non-previleged user.

Env vars

The following environment variables are set as part of the application runtime.

API_ORIGIN

API_ORIGIN is set to the HTTP(S) origin of this Cloudron's API. For example, https://my-girish.cloudron.us.

APP_DOMAIN

APP_DOMAIN is set to the domain name of the application. For example, app-girish.cloudron.us.

APP_ORIGIN

APP_ORIGIN is set to the HTTP(S) origin on the application. This is origin which the user can use to reach the application. For example, https://app-girish.cloudron.us.

CLOUDRON

CLOUDRON is always set to '1'. This is useful to write Cloudron specific code.

WEBADMIN_ORIGIN

WEBADMIN_ORIGIN is set to the HTTP(S) origin of the Cloudron's web admin. For example, https://my-girish.cloudron.us.

Node.js

The base image comes pre-installed with various node.js versions.

They can be used by adding ENV PATH /usr/local/node-<version>/bin:$PATH.

See (/references/baseimage.html#packages) for available versions.

2.7 KiB Raw Blame History