top
(README.md)
# flynn-controller

This is the Flynn Controller. It is inspired by the [Heroku Platform
API](https://devcenter.heroku.com/articles/platform-api-reference) and enables
management of applications running on Flynn via an HTTP API.

The controller depends on PostgreSQL and is typically booted by
[flynn-bootstrap](https://github.com/flynn/flynn-bootstrap).

The API is in a state of flux and is undocumented.
[flynn-cli](https://github.com/flynn/flynn-cli) is one of the API consumers.

## Flynn

[Flynn](https://flynn.io) is a modular, open source Platform as a Service (PaaS).

If you're new to Flynn, start [here](https://github.com/flynn/flynn).

### Status

Flynn is in active development and **currently unsuitable for production** use.

Users are encouraged to experiment with Flynn but should assume there are stability, security, and performance weaknesses throughout the project. This warning will be removed when Flynn is ready for production use.

Please report bugs as issues on the appropriate repository. If you have a general question or don't know which repo to use, report them [here](https://github.com/flynn/flynn/issues).

## Contributing

We welcome and encourage community contributions to Flynn.

Since the project is still unstable, there are specific priorities for development. Pull requests that do not address these priorities will not be accepted until Flynn is production ready.

Please familiarize yourself with the [Contribution Guidelines](https://flynn.io/docs/contributing) and [Project Roadmap](https://flynn.io/docs/roadmap) before contributing.

There are many ways to help Flynn besides contributing code:

 - Fix bugs or file issues
 - Improve the [documentation](https://github.com/flynn/flynn.io) including this website
 - [Contribute](https://flynn.io/#sponsor) financially to support core development

Flynn is a [trademark](https://flynn.io/docs/trademark-guidelines) of Prime Directive, Inc.

Imports 21 package(s)

  1. github.com/flynn/rpcplus
  2. github.com/flynn/pq
  3. code.google.com/p/go.crypto/ssh
  4. github.com/flynn/rpcplus/comborpc
  5. github.com/flynn/flynn-host/types
  6. github.com/flynn/go-flynn/migrate
  7. github.com/flynn/go-flynn/postgres
  8. github.com/flynn/strowger/types
  9. github.com/flynn/flynn-controller/types
  10. github.com/flynn/strowger/client
  11. github.com/martini-contrib/render
  12. github.com/flynn/go-flynn/cluster
  13. github.com/go-martini/martini
  14. github.com/flynn/pq/hstore
  15. github.com/flynn/go-sql
  16. github.com/flynn/go-flynn/demultiplex
  17. github.com/flynn/go-dockerclient
  18. github.com/flynn/flynn-controller/utils
  19. github.com/flynn/go-discoverd
  20. github.com/flynn/go-flynn/resource
  21. github.com/martini-contrib/binding

Test imports 4 package(s)

  1. github.com/flynn/flynn-controller/testutils
  2. github.com/titanous/gocheck
  3. github.com/flynn/discoverd/agent
  4. github.com/flynn/flynn-controller/client