Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

f24 feature: introduce sen, TUI for docker #118

Merged
merged 1 commit into from
Feb 11, 2016
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 61 additions & 0 deletions tools/docker/docker-interactive-management.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: sen
page: docker
section: tools
description: Manage your containers interactively!
---

`sen` is a terminal user interface for docker engine. It allows you to interact with docker within your terminal. You can:

* start, stop, remove, inspect your containers and images
* fetch logs, or even view logs real-time
* searching and filtering with the interface
* `sen` updates listing as events occur (e.g. you can `docker pull` an image in other terminal and it will become available automatically in the interface)
* keybindings are inspired by vim
* and much more!

Feel free to visit [original project](https://github.com/TomasTomecek/sen) page for more information.

![sen preview](/tools/docker/sen-preview.gif)


## Installation

Very simple! Just run:

```
$ sudo dnf install -y sen
```


## Prerequisites

In case you haven't set up your docker instance, please follow [this guide](https://developer.fedoraproject.org/tools/docker/docker-installation.html).

Make sure that docker daemon is running:

```
$ systemctl is-active docker
```


## Usage

Run `sen` from your terminal:

```
$ sen
```

(`sen` requires access to docker, you may need to run it with root privileges if your user cannot access docker)

Then you will be presented with list of all your containers and images. You can navigate via arrows. Sample commands are:

* `s` — start a container
* `t` — stop a container
* `d` — delete a container or an image
* `f` — follow logs of a container
* `l` — get all logs of a container
* `i` — inspect a container or an image

For more commands, type `h` to access help page.
Binary file added tools/docker/sen-preview.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.