Skip to content

gitter-badger/farmer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Farmer License

Farmer is a PaaS that offers a simple API to create, deploy and manage small SaaS projects.

Getting Started

Farmer comes with a installer script with will bring a complete Farmer up in a few minutes.
You only need an Ubuntu 14.04 and git client installed on your server.

Quick Installation

As simple as running commands below:

git clone https://github.com/farmer-project/farmer.git
sudo hack/install

How does it work?

Farmer works very simple for almost any small project.

  1. You put a .farmer.yml in root of your git-hosted project. (Read more about .farmer.yml)
  2. You use farmer-cli to create a single instance of your project with a unique name.
  3. You assign a domain to you box using farmer-cli.
  4. Your web app is up and running.

You can repeat this process for as many projects and as many boxes as you like. That's why it can be used as a small PaaS for your SaaS :)

Farmer Client

To access and manage your Farmer server you need to run our command-line program.
Visit farmer-cli for installation intructions.

Known Issues

  • Currently farmer API (default on port 5549) is accessible by everyone. Please protect this port (e.g. Using an iptables rule) if you want to use Farmer in production environment.

Roadmap

  • v0.1 Basic box management API with domain management.
  • v0.2 Admin UI (with AngularJS).
  • v0.3 Box backups.
  • v0.4 Statistics.
  • v0.5 Load balancing and multi-server support.

License

Visit our MIT License.

About

Farmer is a PaaS that offers a simple API to create, deploy and manage small SaaS projects.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 53.2%
  • Shell 46.8%