A ready to deploy LocomotiveCMS package.
We at Bitaculous really like LocomotiveCMS, it's our favorite tool for developing websites, it's awesome. That's why we built LocoRoco, so you can easier start using LocomotiveCMS on your server.
If you want to run LocomotiveCMS without setting up a server, check out LocomotiveHosting, a first class hosting solution from the team behind LocomotiveCMS. This also supports the development of LocomotiveCMS.
The team behind LocomotiveCMS for creating LocomotiveCMS.
Sony Computer Entertainment for creating The Real LocoRoco, an awesome platform video game.
At Bitaculous we use the following stack to run LocomotiveCMS, that's why this package is made for:
-
Download the LocoRoco master or a specific release
-
Unpack the file
-
Install all dependencies with Bundler
$ bundle install
-
Create the application configuration
Copy resources/config/application.yml to
config/application.yml
and adjust properly -
Start Unicorn
$ unicorn_rails
That's it, LocomotiveCMS should run on.
Use the rspec
bin stub to run the specs:
$ ./bin/rspec
or via Guard:
$ guard -g spec
$ ./bin/spring status
$ ./bin/spring rspec
$ ./bin/spring start
$ ./bin/spring stop
-
Create configurations
Copy resources/config/deploy.rb to
config/deploy.rb
and adjust properlyCopy resources/config/environments/sample.rb to
config/environments/<stage>.rb
and adjust properlyCopy resources/config/deploy/sample.rb to
config/deploy/<stage>.rb
and adjust properlyCopy resources/config/unicorn/sample.rb to
config/unicorn/<stage>.rb
and adjust properly -
Setup
shared
andreleases
directory on stage$ cap <stage> deploy:check:directories
-
Copy configurations to stage
Copy
config/application.yml
to~shared/config/application.yml
(on stage)Copy
config/environments/<stage>.rb
to~shared/config/environments/<stage>.rb
(on stage)Copy
config/unicorn/<stage>.rb
to~shared/config/unicorn/<stage>.rb
(on stage) -
Check that the required files and directories exist on stage
$ cap <stage> deploy:check
-
Adjust LocomotiveCMS initializer (config/initializers/locomotive.rb).
-
Adjust CarrierWave initializer (config/initializers/carrierwave.rb) if assets are hosted on Amazon S3 (optional).
-
Continue with
Regular deployment
-
Check-in and push your changes
-
Run
cap <stage> deploy
to deploy a new version to the specified stage
Start Unicorn
$ cap <stage> unicorn:start
Stop Unicorn (QUIT)
$ cap <stage> unicorn:stop
Restart Unicorn (USR2 + QUIT)
$ cap <stage> unicorn:restart
Clear sessions, cache, and socket files
$ cap <stage> cake task=tmp:clear
Clear sessions
$ cap <stage> cake task=tmp:sessions:clear
Clear cache
$ cap <stage> cake task=tmp:cache:clear
Clear sockets
$ cap <stage> cake task=tmp:sockets:clear
Take a look at resources/config/nginx/sample.conf as an inspiration on how to configure Nginx.
Github Issues are used for managing bug reports and feature requests. If you run into issues, please search the issues and submit new problems here.
This project aims to adhere to Semantic Versioning 2.0.0. Violations of this scheme should be reported as bugs. Specifically, if a minor or patch version is released that breaks backward compatibility, that version should be immediately yanked and / or a new version should be immediately released that restores compatibility.
LocoRoco is released under the MIT License (MIT), see LICENSE.