|
|
# Stork Installation Instructions
|
|
|
|
|
|
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.
|
|
|
|
|
|
## MacOS
|
|
|
|
|
|
MacOS is not officially supported. Here are some instructions for developers to run Stork.
|
|
|
|
|
|
1. Install postgresql: `brew install postgresql`
|
|
|
2. Make sure the service is started: `brew services list` and `brew services start postgresql`
|
|
|
3. Open `psql postgres` and create the user and database:
|
|
|
```
|
|
|
$ psql postgres
|
|
|
psql (11.5)
|
|
|
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
|
|
|
You are now connected to database "stork" as user "thomson".
|
|
|
stork=# create extension pgcrypto;
|
|
|
CREATE EXTENSION
|
|
|
```
|
|
|
4. (optional) Temporarily store the password in STORK_DATABASE_PASSWORD. Otherwise many of the following steps will ask about it: ```export STORK_DATABASE_PASSWORD=stork```
|
|
|
5. Initialize the DB:
|
|
|
```
|
|
|
backend/cmd/stork-db-migrate/stork-db-migrate init
|
|
|
```
|
|
|
6. Upgrade the database:
|
|
|
```
|
|
|
backend/cmd/stork-db-migrate/stork-db-migrate up
|
|
|
```
|
|
|
|
|
|
7. Run the server: ```rake run_server```
|
|
|
8. (in another console) Run the UI frontend: ```rake serve_ui```
|
|
|
9. (in another console) Run the agent: ```rake run_agent```
|
|
|
10. Click add new machine, use localhost:8888. This will at the agent you ran in the step 9 above. |
|
|
\ No newline at end of file |