2020-07-13 05:52:22 +00:00
|
|
|
# Development Setup
|
|
|
|
|
|
|
|
1. Install and run postgres.
|
|
|
|
2. Create postgres user and database (and add uuid extension while you're there
|
|
|
|
):
|
|
|
|
createuser shopkeeper
|
|
|
|
createdb shopkeeper
|
|
|
|
sudo -u postgres -i psql
|
|
|
|
postgres=# ALTER DATABASE shopkeeper OWNER TO shopkeeper;
|
|
|
|
\password shopkeeper
|
|
|
|
postgres=# CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
|
2020-07-23 04:12:56 +00:00
|
|
|
3. Save password somewhere safe and then and add a `.env` file to the project
|
|
|
|
directory with the contents:
|
|
|
|
DATABASE_URL=postgresql://shopkeeper:<password>@localhost/shopkeeper
|
|
|
|
RUST_LOG="shopkeeper=debug"
|
|
|
|
HOST="http://localhost:3030"
|
|
|
|
4. Create a new file at `src/db/refinery.toml` with the contents:
|
|
|
|
[main]
|
|
|
|
db_type = "Postgres"
|
|
|
|
db_host = "localhost"
|
|
|
|
db_port = "5432"
|
|
|
|
db_user = "shopkeeper"
|
|
|
|
db_pass = "<database-password-here>"
|
|
|
|
db_name = "shopkeeper"
|
2020-07-13 05:52:22 +00:00
|
|
|
4. Run `cargo run -- -m` which will compile the app in debug mode and run the
|
|
|
|
database migrations.
|
|
|
|
5. Run `./devserver.sh` to run the dev server (by default it listens at
|
2020-07-23 04:12:56 +00:00
|
|
|
`127.0.0.1:3030`).
|
2020-07-13 05:52:22 +00:00
|
|
|
|
|
|
|
# Todo
|
|
|
|
|
|
|
|
* Make self-contained docker container that can run the app without any setup.
|