Skip to content
GitLab
Projects Groups Topics Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Register
  • Sign in
  • stork stork
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributor statistics
    • Graph
    • Compare revisions
  • Issues 311
    • Issues 311
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 30
    • Merge requests 30
  • Deployments
    • Deployments
    • Releases
  • Packages and registries
    • Packages and registries
    • Container Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
Collapse sidebar
  • ISC Open Source ProjectsISC Open Source Projects
  • storkstork
  • Wiki
  • Install

Install · Changes

Page history
Update Install authored Nov 17, 2019 by Tomek Mrugalski's avatar Tomek Mrugalski
Hide whitespace changes
Inline Side-by-side
Install.md
View page @ 8c565352
......@@ -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.
......
Clone repository
  • Demo
  • Hook To Do List
  • Ideas
  • Install Prometheus Grafana
  • Install
  • Known issues
  • Processes
    • coding guidelines
    • development environment
    • gitlab howto
  • Releases
    • Release notes 0.1
    • Release notes 0.10
    • Release notes 0.11
    • Release notes 0.12
    • Release notes 0.13
View All Pages