Documentation Building : improving the step by step guide

[hubyhuby]

The documentation is very helpful but may be improved for beginners.
It could be modified in this way:

Before building, you need to set your database configuration. By default your database.yml contain the following lines:
production:
url: {{envOr "DATABASE_URL" "postgres://postgresUSER:[email protected]:5432/MY-Database_production?sslmode=disable"}}

You need to complete the postgresUSER postgresPASS according to your server login on postegres.

[YOU BUILD your binary...]

Once your binary is downloaded on your server, you need to manually create your database "MY-Database_production" . Contrary to the dev mode (buffalo dev) the production binary ask you to create the Database by hand.

To do so login postgres and type something like "CREATE DATABASE MY-Database_production;"

MIGRATION
Once created launch your app on the command line with the option "migrate" as following
./MySuperAp migrate
The database tables will then be created.

[Launching your app in dev mode for a test run:

By default if you launch the app like this "./MySuperAp" it will be in development mode, looking for the dev database. Which you might want to run to check it is working in dev mode on your server... In this case you want to type in command line "export ADDR="MY-IP". Which will temporarily set the ADDR variable.
]
Once you are all set, you now want to, launch your app in service mode, by following the tutorial here : https://gobuffalo.io/docs/systemd

PS: after this we could also explain how to integrate buffalo with an existing apache or nginx server. Deploy-> integrating with existing web server