Skip to main content

Runs docker containers with pre-defined parameters

Project description

Runs docker containers with pre-defined parameters. Define run-time parameters in a configuration file to spawn containers easily.

NOTE: Containator was developed with Python 3.4, though it should run on any Python 3.

Install & use

Install the package using:

pip3 install containator

Edit config file to define your containers. A sample config file can be found in the source distribution, or downloaded from the source repository.

Either provide a config file path on the command line with -c argument or let the application read config files at the following default locations. All locations are tried in order and definitions from latter files override previous definitions.

  • /etc/containator.conf

  • ~/.config/containator.conf

  • ~/.containator.conf

After they are configured, individual containers are started by providing their name on the command line, for example:

containator firefox


Containator packages are available from PyPI.

The project page is hosted on

If you find something wrong or know of a missing feature, please create an issue on the project page. If you find that inconvenient or have some security concerns, you could also drop me a line at <>.


Copyright 2015, 2019 Michal Belica <>

Containator is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Containator is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Containator.  If not, see < >.

A copy of the license can be found in the LICENSE file in the distribution.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

containator-0.0.4.tar.gz (17.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page