<!--[metadata]>
+++
title = "STARTX Docker OS Images : FEDORA"
description = "Docker container repository based on latest fedora"
keywords = ["home, docker, startx, fedora, repository, container, swarm, compose, howto, "]
weight=3
+++
<![end-metadata]-->

# Docker OS Images : FEDORA

Simple and lightweight (110Mo) container used for all startx based services and applications published in [Dockerhub registry](https://github.com/startxfr/docker-images). 
This container contain updated core OS rpm (kernel, libs,...) as well as usefull tools like pwgen, tar, zip, psmisc, procps, coreutils, findutils, wget

| [![Build Status](https://travis-ci.org/startxfr/docker-images.svg)](https://travis-ci.org/startxfr/docker-images) | [Dockerhub Registry](https://hub.docker.com/r/startx/fedora) | [Sources](https://github.com/startxfr/docker-images/OS/)             | [STARTX Profile](https://github.com/startxfr) | 
|-------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------|----------------------------------------------------------------------|-----------------------------------------------|


## Container flavours

| Version    | Docker Hub repository                                                   | Fedora distribution                         |
|------------|-------------------------------------------------------------------------|---------------------------------------------|
| Latest     | [`startx/fedora`](https://hub.docker.com/r/startx/fedora)               | Fedora 23 (kernel 4.2 + GNU 3.18  )         |
| 23         | [`startx/fedora`](https://hub.docker.com/r/startx/fedora)               | Fedora 23 (kernel 4.2 + GNU 3.18  )         |
| 22         | [`startx/fedora`](https://hub.docker.com/r/startx/fedora)               | Fedora 22 (kernel 4.0 + GNU 3.16  )         |
| 21         | [`startx/fedora`](https://hub.docker.com/r/startx/fedora)               | Fedora 21 (kernel 3.16 + GNU 3.14  )        |
| 20         | [`startx/fedora`](https://hub.docker.com/r/startx/fedora)               | Fedora 20 (kernel 3.11 + GNU 3.10  )        |

## Running from dockerhub registry

* with `docker` you can run `docker run -it --name="fedora" startx/fedora` from any docker host
* with `docker-compose` you can create a docker-compose.yml file with the following content
```
fedora:
  image: startx/fedora:latest
  container_name: "os-fedora"
  environment:
    CONTAINER_TYPE: "os"
    CONTAINER_SERVICE: "fedora"
    CONTAINER_INSTANCE: "os-fedora"
```

## Using this image in your own container

You can use this Dockerfile template to start a new personalized container based on this container
 ```
FROM startx/fedora:latest
#... your container specifications
CMD ["/bin/run.sh"]
```

## Environment variable

| Variable                  | Type     | Mandatory | Description                                                              |
|---------------------------|----------|-----------|--------------------------------------------------------------------------|
| CONTAINER_INSTANCE        | `string` | `yes`     | Container name. Should be uning to get fine grained log and application reporting
| CONTAINER_TYPE            | `string` | `no`      | Container family (os, service, application. could be enhanced 
| CONTAINER_SERVICE         | `string` | `no`      | Define the type of service or application provided
| HOSTNAME                  | `auto`   | `auto`    | Container unique id automatically assigned by docker daemon at startup


## For advanced users

You you want to use this container and code to build and create locally this container. You can follow theses instructions to setup and working environment.

This section will help you if you want to :
* Get latest version of this container OS
* Enhance container content by adding instruction in Dockefile before build step

You must have a working environment with the source code of this repository. Read and follow [how to setup your working environment](https://github.com/startxfr/docker-images#setup-your-working-environment-mandatory) to get a working directory. The following instructions assume you are at the top level of your working directory.

### Build & run a container using `docker`

1. Jump into the container directory with `cd OS`
2. Build the container using `docker build -t fedora .`
3. Run this container 
  1. Interactively with `docker run -it fedora`. If you add a second parameter (like `/bin/bash`) to will run this command instead of the default entrypoint. Usefull to interact with this container (ex: `/bin/bash`, `/bin/ps -a`, `/bin/df -h`,...) 
  2. As a daemon with `docker run -d fedora`


### Build & run a container using `docker-compose`

1. Jump into the container directory with `cd OS`
2. Run this container 
  1. Interactively with `docker-compose up` Startup logs appears and escaping this command stop the container
  2. As a daemon with `docker-compose up -d`. Container startup logs can be read using `docker-compose logs`

## Running container from docker registry images