diff --git a/debian/changelog b/debian/changelog index 2e5a8bb..1e16fe4 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,10 +1,9 @@ propellor (0.9.3) UNRELEASED; urgency=medium * propellor --spin can now be used to update remote hosts, without - any central git repository being used. The git repository is updated - over propellor's ssh connection to the remote host. The central - git repository is still useful for running propellor from cron, - but this simplifies getting started with propellor. + any central git repository needed. The central git repository is + still useful for running propellor from cron, but this simplifies + getting started with propellor, and allows for more ad-hoc usage. * The git repo url, if any, is updated whenever propellor --spin is used. * Added prosody module, contributed by Félix Sipma. * Can be used to configure tor hidden services. Thanks, Félix Sipma. diff --git a/doc/README.mdwn b/doc/README.mdwn index 50348c3..c509ccd 100644 --- a/doc/README.mdwn +++ b/doc/README.mdwn @@ -35,25 +35,25 @@ see [configuration for the Haskell newbie](https://propellor.branchable.com/hask ## quick start -1. Get propellor installed on your laptop. +1. Get propellor installed on your development machine (ie, laptop). `cabal install propellor` or `apt-get install propellor` -2. Run propellor for the first time. It will set up a `~/.propellor/` git +2. Run `propellor` for the first time. It will set up a `~/.propellor/` git repository for you. 3. If you don't have a gpg private key already, generate one: `gpg --gen-key` 4. Run: `propellor --add-key $KEYID`, which will make propellor trust your gpg key, and will sign your `~/.propellor` repository using it. 5. Edit `~/.propellor/config.hs`, and add a host you want to manage. You can start by not adding any properties, or only a few. -6. Pick a host and run: `propellor --spin $HOST` +6. Run: `propellor --spin $HOST` 7. Now you have a simple propellor deployment, but it doesn't do much to the host yet, besides installing propellor. - So, edit `~/.propellor/config.hs` to configure the host (maybe - start with a few simple properties), and re-run step 6. + So, edit `~/.propellor/config.hs` to configure the host, add some + properties to it, and re-run step 6. Repeat until happy and move on to the next host. :) 8. Optionally, set up a [centralized git repository](https://propellor.branchable.com/centralized_git_repository/) - so multiple hosts can be updated with a simple `git commit -S; git push` + so that multiple hosts can be updated with a simple `git commit -S; git push` 9. Write some neat new properties and send patches! ## debugging