Install.md

@@ -4,6 +4,69 @@
 
 Stork doesn't have any end user installation instructions yet. *Very* early adopters may take a look at the [dependencies](https://gitlab.isc.org/isc-projects/stork/wikis/Development-Environment#dependencies) and [building and running Stork](https://gitlab.isc.org/isc-projects/stork/wikis/Development-Environment#building-testing-and-running-stork) sections of the development environment page.
 
+## Ubuntu (docker)
+
+Get the stork sources, then:
+```
+$ rake docker_up
+```
+This is by far the simplest method. However, it requires docker environment to be up and running.
+
+## Ubuntu (native)
+
+1. Make sure that postgresql is installed:
+
+```
+$ sudo apt install postgresql postgresql-client
+$ sudo systemctl start postgresql
+```
+
+2. You may need to modify pg_hba.conf in /etc/postgresql (may be in 10/main subdir) and tweak the access rights, so the the unix account running Stork code will be able to connect as stork user in postgres.
+
+```
+local   all             all                                     password
+host    all             all             127.0.0.1/32            password
+host    all             all             ::1/128                 password
+```
+
+3. Create the database, stork user and assign necessary permissions:
+```
+# su - postgres
+postgres@ubuntu:~$ psql postgres
+psql (10.10 (Ubuntu 10.10-0ubuntu0.18.04.1))
+Type "help" for help.
+
+postgres=# CREATE USER stork WITH PASSWORD 'stork';
+CREATE ROLE
+postgres=# CREATE DATABASE stork;
+CREATE DATABASE
+postgres=# GRANT ALL PRIVILEGES ON DATABASE stork TO stork;
+GRANT
+postgres=# \c stork
+postgres=# CREATE EXTENSION pgcrypto;
+CREATE EXTENSION
+postgres=# \q
+```
+
+4. Install Rake: `sudo apt install rake`
+5. Build the code:
+```
+rake build_agent build_backend build_migrations build_server build_ui
+```
+6. Initialize the db:
+```
+$ backend/cmd/stork-db-migrate/stork-db-migrate init
+$ backend/cmd/stork-db-migrate/stork-db-migrate up
+```
+
+7. Run server in one console: `rake run_server`
+
+8. Run the UI in another console: `rake serve_ui`
+
+9. Run the agent in the third console: `rake run_agent`
+
+You can now connect to http://localhost:4200, log in and connect your machine available at localhost:8888.
+
 ## MacOS
 
 MacOS is not officially supported. Here are some instructions for developers to run Stork.