docker-documentation/images/docker-taisun.md

5.5 KiB

linuxserver/taisun

GitHub Stars GitHub Release GitHub Package Repository GitLab Container Registry Quay.io MicroBadger Layers Docker Pulls Docker Stars Build Status

Taisun is an application for a Docker enabled device with an emphasis on providing a web based interface for managing a single server. Taisun allows you to:

  • Deploy and manage web based virtual desktops.
  • Deploy Taisun specific stacks of applications
  • Browse available images on popular Docker repositories
  • Import a Docker project from any git repository and start developing on your choice of web based IDE or full Linux desktop
  • Spinup a developer container based on popular frameworks and work from a web based IDE
  • Single click remote server access to Taisun and your Docker applications

Supported Architectures

Our images support multiple architectures such as x86-64, arm64 and armhf. We utilise the docker manifest for multi-platform awareness. More information is available from docker here and our announcement here.

Simply pulling linuxserver/taisun should retrieve the correct image for your arch, but you can also pull specific arch images via tags.

The architectures supported by this image are:

Architecture Tag
x86-64 amd64-latest
arm64 arm64v8-latest
armhf arm32v7-latest

Usage

Here are some example snippets to help you get started creating a container from this image.

docker

docker create \
  --name=taisun \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart unless-stopped \
  linuxserver/taisun

docker-compose

Compatible with docker-compose v2 schemas.

---
version: "2"
services:
  taisun:
    image: linuxserver/taisun
    container_name: taisun
    network_mode: bridge
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - 3000:3000
    restart: unless-stopped

Parameters

Docker images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate <external>:<internal> respectively. For example, -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 outside the container.

Ports (-p)

Parameter Function
3000 Taisun WebUI.

Environment Variables (-e)

Env Function

Volume Mappings (-v)

Volume Function
/var/run/docker.sock Docker Socket on the system

Application Setup

The webui is at http://localhost:3000, for more information on usage see here.

Support Info

  • Shell access whilst the container is running:
    • docker exec -it taisun /bin/bash
  • To monitor the logs of the container in realtime:
    • docker logs -f taisun
  • Container version number
    • docker inspect -f '{{ index .Config.Labels "build_version" }}' taisun
  • Image version number
    • docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/taisun

Versions

  • 19.12.19: - Rebasing to alpine 3.11.
  • 20.07.19: - Build compose bins from source, use minimal docker install from repos.
  • 28.06.19: - Rebasing to alpine 3.10.
  • 30.03.19: - Updating docker-compose build dependancies for musl libc.
  • 23.03.19: - Switching to new Base images, shift to arm32v7 tag.
  • 13.02.19: - Initial release.