Get Started with Flockport

Flockport LXC Installer

The Flockport LXC installer sets up a fully functioning LXC environment across multiple distributions in seconds.

Flockbox

Flockbox is a minimal VM that lets you use LXC and the Flockport App store in seconds. Images available for Virtualbox, VMware and KVM

Manual Install

Do things your way. We have installation guides for various distribution in the manual install tab below.
The Flockport LXC Installer supports the following distributions

To run download the installer here. The installer needs to be run as root or sudo. Ensure you have the xz-utils (xz in CentOS, Fedora) Curl, Wget packages installed. Untar it.

tar -xpJf flockport-install.tar.xz

Then go to the flockport-install folder and run the flockport.run program

./flockport.run

This will install a fully functioning LXC out of the box, along with the Flockport Utility that let's you view and download containers directly to your system from the Flockport App Store. You need a free Flockport account to use the app store.

Flockport-install.tar.xz

You can also download Flockport containers directly from the Flockport App Store. The installer has been tested on cloud instances at Vultr, Digital Ocean and Linode.

Flockport App Store

Flockport Documentation

Flockport LXC Guides

Flockbox is a minimal standalone boot2lxc VM based on Alpine Linux.  Windows, OSX, and even Linux users can try the Flockport App store and LXC in seconds with Flockbox.

Virtualbox
flockbox-vbox.7z 80MB sha md5

VMware
flockbox-vmware.7z 80MB sha md5

KVM
flockbox-kvm.tar.xz 80MB sha md5

KVM Ubuntu Vivid
flockbox-vivid.tar.xz 250MB sha md5

Usage details are in the Readme file. All images are 64 bit. Changelog.

To learn more about the Flockport App Store, how to use Flockport apps and LXC please visit the Documentation Page.

You don't have to use the Flockport LXC installer. You can install your distributions LXC support directly and download the Flockport Utility here

However some distributions for instance Debian Jessie, Fedora 21 and CentOS 7 do not set up LXC networking by default, and Debian Wheezy has extremely outdated LXC packages. Flockport hosts a LXC repo for Wheezy.

The Flockport LXC installer setups and enables a fully functioning LXC out of the box across distributions with minimum fuss.

See our 5 minute guides for your specific distribution here

Using Flockport Containers
Once the installer is done you have a fully functioning LXC environment and can download containers from the Flockport App store, and also create and launch your own containers with ease.

For a quick overview of LXC and using Flockport containers head over to our Documentation Page

See the Flockport Utility and App Store in action

For now let's have a quick rundown of capabilities. The Flockport Utility lets you view and download Flockport containers directly to your system from the Flockport App Store.

Get a list of options

flockport help

Get a list of containers available

flockport list

You need to have a Flockport account to download containers. Use your flockport.com credentials to log in with the flockport utility

flockport login

Once you are logged in you can download containers. For instance to download the WordPress container

flockport get wordpress

This will download the WordPress container and make it available for use on your system.

Once the WordPress container is downloaded start it with the 'lxc-start' command

lxc-start -n wordpress -d

Now you have mini VM running, only operating at bare metal speed. To get information on the container run

lxc-ls -f

This will give you a list of containers on your system and their status. The WordPress container should show here with its IP.

The application will be available in your browser at mywordpress.org. As a convention Flockport containers are configured by default to be available at mycontainername.org.

But before you can access it you need add an entry to your /etc/hosts file like below.

10.0.3.175 mywordpress.org

Now the application will be available at mywordpress.org in your browser.

If you choose instead to download the apps directly from the website you can copy them to the /var/lib/lxc folder and unzip them like below, for instance for the WordPress container.

tar -xpJf wordpress.tar.xz --numeric-owner

Once unzipped you can now start it with the lxc-start command.

You can login to containers by using lxc-attach or ssh to the containers IP.

lxc-attach -n container name

lxc-attach will drop you into a root shell. If you are using ssh the default password for Flockport containers is the distributions name, i.e. for Debian based containers the user will be 'root' and the password will be 'debian'. The exception is Ubuntu for which the user is 'ubuntu' and the password is 'ubuntu'.

Container details including application and database passwords is in the appname.readme file in the root folder of the container. The default user for applications is  usually 'admin' and the password is 'flockport'.

For more details please look at the documentation section and the Flockport Guide here.

Cloud/VPS Instances and Flockbox
If you are deploying containers in public cloud or VPS instances, the container will be in its own private subnet and thus will not be accessible from outside.

Host --> Cloud instance --> Container

In this case you need to port forward your cloud instance's public IP port 80 to the container IP port 80 to access the Flockport app on your host' s browser.

Similarly in a VM you have

Host --> VM --> Container

so you need to port forward the Flockbox VMs port 80 to the container port 80 so you can access the app on your host's browser.

For instance if your cloud public IP is 1.1.1.1 and the container IP is 10.0.3.175, run the command below in the cloud instance to access the container app from outside.

iptables -t nat -I PREROUTING -i eth0 -p TCP -d 1.1.1.1/32 --dport 80 -j DNAT --to-destination 10.0.3.175:80

The same applies for the Flockbox VM. Run the above iptables command inside the VM to forward container port 80 to VM port 80. Once its available on VM port 80 you can access the app on the VM IP from our hosts browser.

Now edit the hosts file on your host to associate the cloud instance public IP or VM IP to the container app like below where 1.1.1.1 is your cloud public IP or in the case of Flockbox the VM IP.

1.1.1.1 mywordpress.org

On Linux the hosts file  '/etc/hosts'. On Windows its '/windows/system32/drivers/etc/hosts' and on OSX its '/etc/hosts' or '/private/etc/hosts'

Please note port forwarding is required in the default network setups. You can setup your networking so you don't need to port forward. You can learn more in our networking section. 

You can  give containers routable public IP and use all other networking options available to VMs. Please head over to our Documentation Section to get an overview on using Flockport containers, LXC and container networking.

Please look at the Flockport Guide linked below or the Flockport Conventions tab alongside for Container details. You do need to do this, how will you login to the container or the app?

Flockport App Store

Flockport Guide

Flockport LXC Guides

Note: The Flockport Installer automates LXC installation across distributions ensuring you have a properly functioning LXC environment out of the box in seconds. If you would prefer to install LXC manually see here for guides for your specific distribution.

The Flockport App store gives your ready to use containers of popular apps and web stacks that can be deployed in seconds on any server, any cloud and any provider.

Say goodbye to the drudgery of installing and configuring web stacks and applications. Download a Flockport container and launch. It's fast, simple and flexible.

Flockport apps are portable can be be cloned, backed up, and moved across servers easily. And give your bare metal performance out of the box.

Please look at the Flockport Guide linked below or the Flockport Conventions tab alongside for Container details. You do need to do this, how will you login to the container or the app?

Flockport App Store

Flockport Guide

Flockport LXC Guides

The Flockport Utility lets you view and download containers directly to your system from the Flockport App Store.

The Flockport installer and VM ship with the Utility. If you did a manual install you can download the Utility here.

You need a Flockport.com account to download apps from the App store.

flockport help

This gives you a list of options to use the utility

flockport list

This lists Flockport containers available for download

flockport login

This prompts you for your credentials and logs you in to enable downloads of Flockport containers. Username and Password are your flockport.com credentials.

flockport status

This checks your login status

flockport get containername

This downloads the selected container and makes it available for use in your system

flockport get md5
flockport get sha

This will download the md5/shasum of flockport containers to your LXC folder

flockport version

This gives you the Flockport utility and LXC version currently installed on you system

The utility is fairly straight forward. Errors if any will be related to invalid or expired login credentials or erroneous container names. Please check these carefully if you get errors.

flockport logout

This deletes the cache and logs you out. Useful if you get any errors.

Flockport App Store

Flockport Guide

Flockport LXC Guides

Login

Register | Lost your password?